UDYAM APIs
Submit OTP

Introduction
The Submit OTP API allows you to retrieve UDYAM registration details and certificate by submitting the OTP that was sent to the registered mobile number generated using Generate OTP API. Using this API, you can retrieve Basic details (Name of owner, name of enterprise, Contact details), Bank account details, Unit details, Investment in machinery, NIC codes, official address, and UDYAM certificate. This serves as a crucial tool to verify the authenticity of MSMEs (Micro, Small, and Medium Enterprises) registered under India's Udyam scheme.
﻿
API details
Endpoint
Production Environment
POST https://api.signzy.app/api/v3/udyamcertificate/submitotp
POST https://api.signzy.app/api/v3/udyamcertificate/submitotp
﻿
UAT/Testing environment
POST https://api-preproduction.signzy.app/api/v3/udyamcertificate/submitotp
POST https://api-preproduction.signzy.app/api/v3/udyamcertificate/submitotp
﻿
﻿
Request headers 
Name
Value
Required
Description
Content-Type
application/json
Mandatory
The type of content that the request body contains.
Authorization
XXXXXXXXXXXXXXX
Mandatory
An authentication token to authorize the request. Reach out to the Signzy support team to get one created.
﻿
Request body parameters
Parameter
Data Type
Description
Required
requestId
String
Unique ID for the request. 
Refer to Generate OTP API for the requestId to be generated.
Mandatory
otp
String
OTP received to the registered mobile number.
Mandatory
JSON
{
    "requestId": "udyam_otp_sbRuUCntxXODadCGJwly",
    "otp": "123456"
}
{
    "requestId": "udyam_otp_sbRuUCntxXODadCGJwly",
    "otp": "123456"
}
﻿
﻿
Code samples
Curl
Node.js
Python
Go
curl --location 'https://api-preproduction.signzy.app/api/v3/udyamcertificate/submitotp' \
--header 'Authorization: <Your access token>' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "udyam_otp_sbRuUCntxXODadCGJwly",
    "otp": "123456"
}'
curl --location 'https://api-preproduction.signzy.app/api/v3/udyamcertificate/submitotp' \
--header 'Authorization: <Your access token>' \
--header 'Content-Type: application/json' \
--data '{
    "requestId": "udyam_otp_sbRuUCntxXODadCGJwly",
    "otp": "123456"
}'
﻿
﻿
Response body parameters
Parameter
Data Type
Description
result
Object
Contains the result of the task.
result.typeOfEnterprise
String
Type of enterprise.
The possible values are:
Micro,
Small,
Medium.
result.majorActivity
String
Major Activity of the enterprise.
The possible values are:
Trading,
manufacturing,
Services
result.typeOfOrganisation
String
Type of organization.
result.nameOfEnterprise
String
Name of the enterprise.
result.ownerName
String
Name of the enterprise's owner.
result.pan
String
PAN of the enterprise.
result.isGstinAvailable
String
Indicate if GSTIN is available.
The possible values are:
Yes,
No.
result.email
String
Email ID of the enterprise.
result.socialCategory
String
Social category of the owner.
result.gender
String
Gender of the owner.
The possible values are:
Male,
Female.
result.isSpeciallyAbled
String
Indicates if the owner is specially abled.
The possible values are: 
Yes,
No.
result.dateOfIncorporation
String
Date of registration of the enterprise.In format YYYY-MM-DD.
result.dateOfCommencementOfBusiness
String
Date of commencment of business/ production.In format YYYY-MM-DD.
result.bankDetails
Array of objects
Contains the bank account details of the enterprise.
result.bankDetails.bankName
String
Name of the bank.
result.bankDetails.ifscCode
String
IFSC code of the bank.
result.bankDetails.bankAccountNumber
String
Bank account number.
result.employmentDetails
Array of strings
Contains employment details of the enterprise.
result.employmentDetails.male
String
Number of male employees.
result.employmentDetails.female
String
Number of female employees.
result.employmentDetails.other
String
Number of employees of other genders.
result.employmentDetails.total
String
Total number of employees.
result.investmentInPlantAndMachinery
Array of objects
Contains investment in plant and machinery details.
result.investmentInPlantAndMachinery.slNo
String
Serial number.
result.investmentInPlantAndMachinery.financialYear
String
Financial year.In format YYYY-YY.
result.investmentInPlantAndMachinery.enterpriseType
String
Type of enterprise.
The possible values are: 
Micro,
Small,
medium.
result.investmentInPlantAndMachinery.writtenDownValue
String
Written down value of investments in INR.
result.investmentInPlantAndMachinery.exclusionCost
String
Cost exclusions in INR.
result.investmentInPlantAndMachinery.netInvestment
String
Net Investment In INR
result.investmentInPlantAndMachinery.totalTurnover
String
Total turnover in INR
result.investmentInPlantAndMachinery.exportTurnover
String
Export turnover in INR.
result.investmentInPlantAndMachinery.netTurnover
String
Net turnover in INR.
result.investmentInPlantAndMachinery.isItrFiled
String
Indicates if Income Tax Retruns (ITR) is filed.
The possible values are: 
Yes,
No.
result.investmentInPlantAndMachinery.ItrType
String
Type of ITR filed.
result.unitDetails
Array of objects
Contains manufacturing units of the enterprise details.
result.unitDetails.slNo
String
Serial number.
result.unitDetails.unitName
String
Name of the unit.
result.unitDetails.flat
String
Flat/door/block number.
result.unitDetails.building
String
Name of the building.
result.unitDetails.villageTown
String
Village or town name.
result.unitDetails.block
String
Block name.
result.unitDetails.road
String
Road or Street or lane name.
result.unitDetails.city
String
City.
result.unitDetails.state
String
State.
result.unitDetails.district
String
District.
result.unitDetails.pinCode
String
Pincode.
result.officialAddress
Object
Contains official address of the enterprise.
result.officialAddress.flatDoorBlockNumber
String
Flat, door, or block number
result.officialAddress.building
String
Name of the building.
result.officialAddress.villageTown
String
Village or town name.
result.officialAddress.block
String
Block name.
result.officialAddress.roadStreetLane
String
Road or Street or Lane name.
result.officialAddress.city
String
City.
result.officialAddress.state
String
State.
result.officialAddress.district
String
District.
result.officialAddress.pinCode
String
Pincode.
result.officialAddress.mobile
String
Mobile number of the enterprise.
result.officialAddress.email
String
Email ID of the enterprise.
result.nicCode
Array of objects
Contains the NIC (National Industrial Classification) codes
result.nicCode.slNo
String
Serial number.
result.nicCode.nic2digit
String
2-digit NIC code
result.nicCode.nic4digit
String
4-digit NIC code
result.nicCode.nic5digit
String
5-digit NIC code
result.nicCo.activity
String
Type of activity.
result.gemPortal
String
Indicates if registered on GeM Portal. 
The possible values are:
Yes,
No.
result.tredsPortal
String
Indicates if registered on TReDS Portal.
The possible values are: 
Yes,
No.
result.ncsPortal
String
Indicates if registered on NCS Portal.
The possible values are: 
Yes,
No.
result.nsicPortal
String
Indicates if registered on NSIC Portal.
The possible values are: 
Yes,
No.
result.dateOfUdyamRegistration
String
Date of Udyam registration.In format YYYY-MM-DD
result.udyamCertificate
String
URL to the Udyam certificate.
200
400
401
{
    "result": {
        "typeOfEnterprise": "SMALL",
        "majorActivity": "Services",
        "typeOfOrganisation": "Private Limited Company",
        "nameOfEnterprise": "Sample Company",
        "ownerName": "Joe Sample",
        "pan": "ABCD1234E",
        "isGstinAvailable": "Yes",
        "email": "[email protected]",
        "socialCategory": "General",
        "gender": "Male",
        "isSpeciallyAbled": "No",
        "dateOfIncorporation": "2018-01-01",
        "dateOfCommencementOfBusiness": "2018-01-01",
        "bankDetails": [
            {
                "bankName": "ABC bank",
                "ifscCode": "ABCD123456",
                "bankAccountNumber": "123456789012345"
            }
        ],
        "employmentDetails": [
            "male": "10",
            "female": "20",
            "other": "18",
            "total": "48"
        ],
        "investmentInPlantAndMachinery": [
            {
                "slNo": "1",
                "financialYear": "2020-21",
                "enterpriseType": "Small",
                "writtenDownValue": "123456.00",
                "exclusionCost": "0.00",
                "netInvestment": "123456.00",
                "totalTurnover": "123456.00",
                "exportTurnover": "123456.70",
                "netTurnover": "123456.30",
                "isItrFiled": "Yes",
                "ItrType": "ITR - 3, 5, 6"
            },
            {
                "slNo": "2",
                "financialYear": "2019-20",
                "enterpriseType": "Small",
                "writtenDownValue": "654321.00",
                "exclusionCost": "0.00",
                "netInvestment": "654321.00",
                "totalTurnover": "654321.00",
                "exportTurnover": "654321.61",
                "netTurnover": "654321.39",
                "isItrFiled": "Yes",
                "ItrType": "ITR - 3, 5, 6"
            }
        ],
        "unitDetails": [
            {
                "slNo": "1",
                "unitName": "Sample Company",
                "flat": "Apt 12",
                "building": "ABC Business Park",
                "villageTown": "Mumbai",
                "block": "Tower A",
                "road": "ABC road",
                "city": "Mumbai",
                "state": "MAHARASHTRA",
                "district": "MUMBAI",
                "pinCode": "400013"
            },
            {
                "slNo": "2",
                "unitName": "Sample Company",
                "flat": "Qwerty 5th floor",
                "building": "Tower 1",
                "villageTown": "Mumbai",
                "block": "Apple block",
                "road": "Baseball road",
                "city": "Mumbai",
                "state": "MAHARASHTRA",
                "district": "MUMBAI",
                "pinCode": "400013"
            }
        ],
        "officialAddress": {
            "flatDoorBlockNumber": "Qwerty 5th floor",
            "building": "Tower 1",
            "villageTown": "Mumbai",
            "block": "Apple block",
            "roadStreetLane": "Baseball road",
            "city": "Mumbai",
            "state": "MAHARASHTRA",
            "district": "MUMBAI ",
            "pinCode": "400013",
            "mobile": "1234567890",
            "email": "[email protected]"
        },
        "nicCode": [
            {
                "slNo": "1",
                "nic2digit": "62 - Computer programming, consultancy and related activities",
                "nic4digit": "6209 - Other information technology and computer service activities",
                "nic5digit": "62099 - Other information technology and computer service activities n.e.c",
                "activity": "Services"
            }
        ],
        "gemPortal": "No",
        "tredsPortal": "No",
        "ncsPortal": "No",
        "nsicPortal": "No",
        "dateOfUdyamRegistration": "2021-01-01",
        "udyamCertificate": "<Certificate URL>"
    }
}
{
    "result": {
        "typeOfEnterprise": "SMALL",
        "majorActivity": "Services",
        "typeOfOrganisation": "Private Limited Company",
        "nameOfEnterprise": "Sample Company",
        "ownerName": "Joe Sample",
        "pan": "ABCD1234E",
        "isGstinAvailable": "Yes",
        "email": "abcd@efgh.com",
        "socialCategory": "General",
        "gender": "Male",
        "isSpeciallyAbled": "No",
        "dateOfIncorporation": "2018-01-01",
        "dateOfCommencementOfBusiness": "2018-01-01",
        "bankDetails": [
            {
                "bankName": "ABC bank",
                "ifscCode": "ABCD123456",
                "bankAccountNumber": "123456789012345"
            }
        ],
        "employmentDetails": [
            "male": "10",
            "female": "20",
            "other": "18",
            "total": "48"
        ],
        "investmentInPlantAndMachinery": [
            {
                "slNo": "1",
                "financialYear": "2020-21",
                "enterpriseType": "Small",
                "writtenDownValue": "123456.00",
                "exclusionCost": "0.00",
                "netInvestment": "123456.00",
                "totalTurnover": "123456.00",
                "exportTurnover": "123456.70",
                "netTurnover": "123456.30",
                "isItrFiled": "Yes",
                "ItrType": "ITR - 3, 5, 6"
            },
            {
                "slNo": "2",
                "financialYear": "2019-20",
                "enterpriseType": "Small",
                "writtenDownValue": "654321.00",
                "exclusionCost": "0.00",
                "netInvestment": "654321.00",
                "totalTurnover": "654321.00",
                "exportTurnover": "654321.61",
                "netTurnover": "654321.39",
                "isItrFiled": "Yes",
                "ItrType": "ITR - 3, 5, 6"
            }
        ],
        "unitDetails": [
            {
                "slNo": "1",
                "unitName": "Sample Company",
                "flat": "Apt 12",
                "building": "ABC Business Park",
                "villageTown": "Mumbai",
                "block": "Tower A",
                "road": "ABC road",
                "city": "Mumbai",
                "state": "MAHARASHTRA",
                "district": "MUMBAI",
                "pinCode": "400013"
            },
            {
                "slNo": "2",
                "unitName": "Sample Company",
                "flat": "Qwerty 5th floor",
                "building": "Tower 1",
                "villageTown": "Mumbai",
                "block": "Apple block",
                "road": "Baseball road",
                "city": "Mumbai",
                "state": "MAHARASHTRA",
                "district": "MUMBAI",
                "pinCode": "400013"
            }
        ],
        "officialAddress": {
            "flatDoorBlockNumber": "Qwerty 5th floor",
            "building": "Tower 1",
            "villageTown": "Mumbai",
            "block": "Apple block",
            "roadStreetLane": "Baseball road",
            "city": "Mumbai",
            "state": "MAHARASHTRA",
            "district": "MUMBAI ",
            "pinCode": "400013",
            "mobile": "1234567890",
            "email": "abc@xyz.com"
        },
        "nicCode": [
            {
                "slNo": "1",
                "nic2digit": "62 - Computer programming, consultancy and related activities",
                "nic4digit": "6209 - Other information technology and computer service activities",
                "nic5digit": "62099 - Other information technology and computer service activities n.e.c",
                "activity": "Services"
            }
        ],
        "gemPortal": "No",
        "tredsPortal": "No",
        "ncsPortal": "No",
        "nsicPortal": "No",
        "dateOfUdyamRegistration": "2021-01-01",
        "udyamCertificate": "<Certificate URL>"
    }
}
﻿
﻿
Contact Us for Any Assistance
If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email 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!
Generate OTP
Vehicle Side Image Extraction API
Docs powered by Archbee
TABLE OF CONTENTS
Request body parameters
Code samples
Response body parameters
Name	Value	Required	Description
Content-Type	application/json	Mandatory	The type of content that the request body contains.
Authorization	XXXXXXXXXXXXXXX	Mandatory	An authentication token to authorize the request. Reach out to the Signzy support team to get one created.
Parameter	Data Type	Description	Required
requestId	String	Unique ID for the request. Refer to Generate OTP API for the requestId to be generated.	Mandatory
otp	String	OTP received to the registered mobile number.	Mandatory