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
email	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!