PAN to Udyam API Documentation
Overview
The PAN to Udyam API allows users to retrieve Udyam Aadhaar registration details associated with a given Permanent Account Number (PAN). This API is useful for applications requiring business identity validation, especially in KYC/AML and SME onboarding processes.
Use Cases
Udyam Validation
Verify if a PAN is registered under Udyam Aadhaar. Validate the authenticity and business nature of the enterprise.
Prefilling Data
Auto-populate onboarding or registration forms with enterprise details such as:
- Name of enterprise
- Type and size of business
- Address and classification details
Input Payload
cURL
Endpoint: POST curl --location 'https://api.signzy.app/api/v3/udyam/get-udyam-by-pan' \
curl --location 'https://api-preproduction.signzy.app/api/v3/udyam/get-udyam-by-pan' \
--header 'Authorization: <auth token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"panNumber": "Sample PAN"
}'Description table
input parameter | data type | description |
|---|---|---|
panNumber | string | pan number of businesses for which we want to find the udyam number |
Output Payload
Json Response
{
"result": {
"inputPan": "string",
"udyamNumber": "string",
"udyamDetails": {
"generalInfo": {
"udyamRegistrationNumber": "string",
"nameOfEnterprise": "string",
"majorActivity": "string",
"organisationType": "string",
"socialCategory": "string",
"dateOfIncorporation": "string (date, dd/MM/yyyy)",
"dateOfCommencementOfProductionBusiness": "string (date, dd/MM/yyyy)",
"dic": "string",
"msmedi": "string",
"dateOfUdyamRegistration": "string (date, dd/MM/yyyy)",
"typeOfEnterprise": "string",
"gender": "string",
"msmedfo": "string"
},
"enterpriseType": [
{
"sno": "integer as string",
"dataYear": "string (financial year)",
"classificationYear": "string (financial year)",
"enterpriseType": "string",
"classificationDate": "string (date, dd/MM/yyyy)"
}
],
"unitsDetails": [
{
"sn": "integer as string",
"unitName": "string",
"flat": "string",
"building": "string",
"villageTown": "string",
"block": "string",
"road": "string",
"city": "string",
"pin": "string",
"state": "string",
"district": "string"
}
],
"officialAddressOfEnterprise": {
},
"nationalIndustryClassificationCodes": [
{
"sno": "integer as string",
"nic2Digit": "string",
"nic4Digit": "string",
"nic5Digit": "string",
"activity": "string",
"date": "string (date, dd/MM/yyyy)"
}
],
"pdfUrl": "string (URL)"
}
}
}Table
Output Parameter | data type | description |
|---|---|---|
result.inputPan | string | Input the PAN number to find the udyam number |
result.udyamNumber | string | Udyam number found for the given PAN |
General Info Section
Output Parameter | Data Type and Format | Description |
|---|---|---|
udyamRegistrationNumber | string. 16-digit unique number ex: UDYAM-KA-00-1234567 | Udyam Registration number is a 16-digit long ID allocated to businesses registered in the udyam ecosystem |
nameOfEnterprise | String | The name of the enterprise is the official name given name given in the udyam registration |
majorActivity | string | Major Activity indicates the declaration of a broad business operation |
organisationType | string | The type of organisation tells the constitution of the business |
socialCategory | string | Social category indicates the social class of the authorised person |
dateOfIncorporation | string Format: dd/mm/yyyy | Date of incorporation of udyam |
dateOfCommencementOfProductionBusiness | string. Format: dd/mm/yyyy | Date of business commencement |
dic | string | District Industries Centre name of udyam |
msmedi | string | Name of the MSME development institute |
dateOfUdyamRegistration | string | Date when udyam was registered on the udyam portal |
typeOfEnterprise | string | Signifies the current status of msme under msme classification |
gender | string | Gender of the authorised person |
msmedfo | string | msme development organisation |
Enterprise-Type Section
Output Details | Data Type and Format | Description |
|---|---|---|
sno | integer as string | serial number of classification |
dataYear | string | Financial year of classification data |
classificationYear | string | Year of classification |
enterpriseType | string | enterprise type set after classification |
classificationDate | string | Date of classification allotment |
Unit Details Section
Output Parameter | Data type and format | Description |
|---|---|---|
sn | Integer as a string | Serial number of the unit registered in udyam |
unitName | string | Name of unit |
flat | string | flat number and details of the registered unit |
building | string | Building details of the unit |
villageTown | string | Town or village name of the udyam registered |
block | string | Block of unit address |
road | string | Road name of the unit address |
city | string | City name of the registered udyam unit |
pin | string | Pincode of the udyam unit address |
state | string | State of the registered Udyam unit |
district | string | District of the registered udyam unit |
Official Address Section
Output Parameter | Data type and format | Description |
|---|---|---|
flatDoorBlockNo | Integer as a string | Serial number of the unit registered in udyam |
nameOfPremisesBuilding | string | Name of premises building |
villageTown | string | Town or village name of the udyam registered |
block | string | Block of unit address |
roadStreetLane | string | Road name of the unit address |
city | string | City name of the registered udyam unit |
pin | string | Pincode of the udyam unit address |
state | string | State of the registered Udyam unit |
district | string | District of the registered udyam unit |
mobile | string | Registered mobile of the msme |
stirng | Registered email of the msme |
National Industry Classification Code section
Output Parameter | Data type and format | Description |
|---|---|---|
sno | Integer as a string | Serial number of the unit registered |
nic2Digit | string | First 2 digits of the NIC code helps in broad classification of udyam registration |
nic4Digit | string | Four digits of the NIC code for classification of udyam |
nic5Digit | string | Five digit udyam number to classify udyam numbers and their operation category |
activity | string | Activity classification of the udyam number |
date | string | Date of allotment of udyam number |
Error Codes
Code | status | Description |
|---|---|---|
200 | Success | The data is fetched successfully for given input |
400 | Invalid Input | The pan provided in the input parameters was incorrect |
404 | Udyam Data not found | Udyam data not found in the source |
409 | Upstream Error | Error in fetching data from upstream |
500 | Internal Server Error | Something is broken. This is usually a temporary error, for example in a high-load situation.or if an endpoint is temporarily having issues. Try again later. |
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!