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/Data

Workflow 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:

{ "udyamNumber": "UDYAM-HH-01-0116372", "timeout": "900", "id": 96, "result": { "requestId": "fa456a39948022af495c5757", "timeout": true, "message": "Success, request is in process" } }

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)

{ "error": { "name": "error", "message": "The Udyam Number is of Invalid Format, the format must be similar to 'UDYAM-XX-00-0000000'. Refer Docs for more details", "status": 400, "reason": "VALIDATION_ERROR", "type": "Bad Request", "statusCode": 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:

{ "requestId": "26d12602b3c35a3390bea27f", "id": 15, "result": { "dataPushedToCallback": true, "generalInfo": { "udyamRegistrationNumber": "UDYAM-MH-01-0116372", "nameOfEnterprise": "HRISHIKESH BHARAT KESEKAR", "majorActivity": "TRADING[For availing benefits of Priority Sector Lending(PSL) ONLY]", "organisationType": "Proprietary", "socialCategory": "OBC", "dateOfIncorporation": "01/06/2023", "dateOfCommencementOfProductionBusiness": "01/06/2023", "dic": "AHMEDNAGAR", "msmedi": "MUMBAI", "dateOfUdyamRegistration": "20/07/2023", "typeOfEnterprise": "Micro", "gender": "Male", "msmedfo": "MUMBAI" }, "enterpriseType": [...], "unitsDetails": [...], "officialAddressOfEnterprise": {...}, "nationalIndustryClassificationCodes": [...], "pdfUrl": "https://persist.signzy.tech/api/files/..." } }

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)

{ "requestId": "94152b6267af782134e3719a", "id": 43, "result": { "name": "in progress", "message": "Data not received from udyam portal for the given requestId", "status": 200, "reason": "PROCESSING", "type": "OK", "statusCode": 200 } }

Udyam Details Not Found (200)

{ "requestId": "94152b6267af782134e3719a", "id": 43, "result": { "name": "Not Found", "message": "Data not found for the given udyam", "status": 200, "reason": "DATA NOT FOUND", "type": "OK", "statusCode": 200 } }

Request ID Not Found (404)

{ "error": { "message": "RequestId not found", "status": 404, "reason": "REQUEST_ID_NOT_FOUND" } }

Validation Failed (400)

{ "requestId": "94152b6267af782134e3719a", "id": 43, "result": { "name": "Validation failed", "message": "Udyam number is not valid", "status": 400, "reason": "VALIDATION FAILED", "type": "OK", "statusCode": "400" } }

Timeout Error (409)

{ "requestId": "94152b6267af782134e3719a", "id": 43, "result": { "name": "timeout", "message": "Udyam details not fetched with user set timeout", "status": 409, "reason": "TIMEOUT ERROR", "type": "OK", "statusCode": "409" } }

Upstream Server Issues (409)

{ "error": { "message": "upstream server issue, please try again in sometime", "status": 409, "reason": "UPSTREAM_ERROR" } }

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