Udyam Registration Async

Udyam Async API Documentation
Overview
The Udyam Async API is a comprehensive solution designed for enterprises, banks, and financial institutions to seamlessly access real-time Udyam registration data through an asynchronous processing framework. Built specifically for high-volume enterprise environments, this API eliminates the complexity of direct government portal interactions while ensuring data accuracy and reliability. The system operates through a sophisticated two-step process: first generating a unique request identifier, then retrieving processed enterprise data with automatic retry mechanisms and callback support. This robust architecture enables organizations to integrate Udyam verification into their existing workflows without disrupting user experience, making it ideal for account opening procedures, merchant onboarding processes, and loan application journeys where enterprise verification is critical.
Key Use Cases
1. Udyam Current Account Journey
Streamline business account opening by automatically verifying enterprise registration details, reducing manual documentation requirements and accelerating approval processes.
2. Merchant Onboarding
Enable instant merchant verification during payment gateway registration, ensuring compliance with regulatory requirements while maintaining smooth onboarding experience.
3. Loan Journey
Integrate enterprise verification into lending workflows, allowing financial institutions to assess business legitimacy and creditworthiness through verified government data.
API Workflow
sequenceDiagram
participant Client
participant API
participant Source
participant Callback
Client->>API: POST /GetRequestId (Udyam Number)
API->>API: Validate Input
API->>Client: Return Request ID
API->>Source: Initiate Data Fetch
loop Retry Mechanism (Max 24 hours)
Source->>Source: Attempt Data Retrieval
alt Data Found
Source->>API: Return Udyam Data
API->>Callback: POST Data (if URL provided)
else Data Not Found
Source->>Source: Wait & Retry
end
end
Client->>API: GET /fetchData (Request ID)
API->>Client: Return Current Status/DataWorkflow Steps:
- Initiate Request: Submit Udyam number with optional callback URL and timeout
- Generate Request ID: System validates input and returns unique identifier
- Background Processing: API attempts data retrieval with intelligent retry logic
- Status Polling: Client checks request status using request ID
- Data Delivery: Receive complete Udyam details via API response or callback
API Specifications
1. Initiate Udyam Data Request
Endpoint: POST /GetRequestId
Initiates an asynchronous request to fetch the latest Udyam registration details by generating a unique request ID.
cURL Example
curl --location 'https://api.signzy.app/api/v3/udyam/registration/GetRequestId' \
--header 'Content-Type: application/json' \
--header 'Authorization: YOUR_API_KEY' \
--data '{
"udyamNumber": "Udyam Number",
"timeout": "6000",
"callbackUrl": "https://callback.com",
"isBase64": true/false
}'Input Parameters
Field Name | Data Type | Description | Mandatory/Optional |
|---|---|---|---|
udyamNumber | string | Udyam registration number in format UDYAM-XX-00-0000000 | Mandatory |
callbackUrl | string | Webhook URL to receive data when processing completes | Optional |
timeout | string | Maximum wait time in seconds (Min: 10, Max: 86400) | Optional |
isBase64 | boolean | Boolean to get udyam details pdf in base64 format | Optional |
Success Response (200)
Response Structure:
Success Response Fields:
Field Name | Data Type | Description |
|---|---|---|
udyamNumber | string | Submitted Udyam registration number |
timeout | string | Applied timeout value in seconds |
id | integer | Internal tracking ID |
result.requestId | string | Unique identifier for tracking the request |
result.timeout | boolean | Indicates if timeout was applied |
result.message | string | Status message confirming request initiation |
Error Scenarios
Invalid Udyam Number Format (400)
2. Get Udyam Data Status
Endpoint: GET /fetchData
Retrieves the current status and data for a previously initiated Udyam request using the request ID.
cURL Example
curl --location 'https://api-preproduction.signzy.app/api/v3/udyam/registration/fetchData' \
--header 'Content-Type: application/json' \
--header 'Authorization: YOUR_API_KEY' \
--data '{
"requestId": "249ae5f6a82bf3efea84a1a8"
}'Input Parameters
Field Name | Data Type | Description | Mandatory/Optional |
|---|---|---|---|
requestId | string | Request ID obtained from the GetRequestId endpoint | Mandatory |
Success Response (200) - Data Available
Response Structure:
Success Response Fields:

Field Name | Data Type | Description |
|---|---|---|
requestId | string | Original request identifier |
id | integer | Internal tracking ID |
result.dataPushedToCallback | boolean | Indicates if data was sent to callback URL |
General Information |  |  |
result.generalInfo.udyamRegistrationNumber | string | Official Udyam registration number |
result.generalInfo.nameOfEnterprise | string | Registered enterprise name |
result.generalInfo.majorActivity | string | Primary business activity |
result.generalInfo.organisationType | string | Organization type (Proprietary, Partnership, etc.) |
result.generalInfo.socialCategory | string | Social category classification (OBC, SC, ST, General) |
result.generalInfo.dateOfIncorporation | string | Business incorporation date (DD/MM/YYYY) |
result.generalInfo.dateOfCommencementOfProductionBusiness | string | Business commencement date (DD/MM/YYYY) |
result.generalInfo.dic | string | District Industries Centre |
result.generalInfo.msmedi | string | MSME Development Institute |
result.generalInfo.dateOfUdyamRegistration | string | Udyam registration date (DD/MM/YYYY) |
result.generalInfo.typeOfEnterprise | string | Enterprise size classification (Micro/Small/Medium) |
result.generalInfo.gender | string | Gender of proprietor/owner |
result.generalInfo.msmedfo | string | MSME Development Field Office |
Enterprise Classification |  |  |
result.enterpriseType[].sno | string | Serial number |
result.enterpriseType[].dataYear | string | Financial year of data |
result.enterpriseType[].classificationYear | string | Year of enterprise classification |
result.enterpriseType[].enterpriseType | string | Enterprise type classification |
result.enterpriseType[].classificationDate | string | Date of classification |
Unit Details |  |  |
result.unitsDetails[].sn | string | Serial number |
result.unitsDetails[].unitName | string | Name of the business unit |
result.unitsDetails[].flat | string | Flat/Shop number |
result.unitsDetails[].building | string | Building name |
result.unitsDetails[].villageTown | string | Village or town name |
result.unitsDetails[].block | string | Block/Survey number |
result.unitsDetails[].road | string | Road/Street name |
result.unitsDetails[].city | string | City name |
result.unitsDetails[].pin | string | Postal code |
result.unitsDetails[].state | string | State name |
result.unitsDetails[].district | string | District name |
Official Address |  |  |
result.officialAddressOfEnterprise.flatDoorBlockNo | string | Flat/Door/Block number |
result.officialAddressOfEnterprise.nameOfPremisesBuilding | string | Building/Premises name |
result.officialAddressOfEnterprise.villageTown | string | Village/Town |
result.officialAddressOfEnterprise.block | string | Block/Survey number |
result.officialAddressOfEnterprise.roadStreetLane | string | Road/Street/Lane |
result.officialAddressOfEnterprise.city | string | City |
result.officialAddressOfEnterprise.state | string | State |
result.officialAddressOfEnterprise.pin | string | PIN code |
result.officialAddressOfEnterprise.district | string | District |
result.officialAddressOfEnterprise.mobile | string | Mobile number (partially masked) |
result.officialAddressOfEnterprise.email | string | Email address |
NIC Classification |  |  |
result.nationalIndustryClassificationCodes[].sno | string | Serial number |
result.nationalIndustryClassificationCodes[].nic2Digit | string | 2-digit NIC code with description |
result.nationalIndustryClassificationCodes[].nic4Digit | string | 4-digit NIC code with description |
result.nationalIndustryClassificationCodes[].nic5Digit | string | 5-digit NIC code with description |
result.nationalIndustryClassificationCodes[].activity | string | Type of activity (Services/Manufacturing/Trading) |
result.nationalIndustryClassificationCodes[].date | string | Date of NIC classification |
result.pdfUrl | string | Direct download link to the official Udyam certificate PDF |
Error Response Scenarios
Request In Progress (200)
Udyam Details Not Found (200)
Request ID Not Found (404)
Validation Failed (400)
Timeout Error (409)
Upstream Server Issues (409)
Status Codes Reference
Status Code | Message | Description | Action Required |
|---|---|---|---|
200 | OK | Request processed successfully | Continue with normal flow |
400 | Bad Request | Invalid input parameters or validation failure | Check input format and retry |
404 | Not Found | Request ID not found in system | Verify request ID or reinitiate request |
409 | Conflict | Timeout exceeded or upstream server issues | Wait and retry, or contact support |
409 | TIMEOUT ERROR | User-defined timeout exceeded | Increase timeout or reinitiate request |