API reference / Business / KYB
Udyam (MSME) verification
Enterprise name, type, units, official address and NIC codes for a Udyam registration number, with the certificate PDF link.
POST
/v1/business/udyam- Authentication
- Bearer token
- Scope
kyc:verify
Request body
| Field | Type | Required | Description |
|---|---|---|---|
udyam_number | string | Yes | Udyam registration number in the form UDYAM-XX-00-0000000: state code, two digits, seven digits. Case and spaces are ignored; keep the hyphens. |
Sample code
Set your key in the GRAPPI_API_KEY environment variable. Sample values are placeholders.
curl -sS -X POST 'https://grappi.ai/v1/business/udyam' \
-H "Authorization: Bearer $GRAPPI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"udyam_number": "UDYAM-MH-19-0012345"
}'Sample response
{
"request_id": "req_01HZY3K8M2",
"result": {
"general_info": {
"udyam_registration_number": "UDYAM-MH-19-0012345",
"name_of_enterprise": "EXAMPLE TRADERS",
"type_of_enterprise": "Micro",
"major_activity": "Trading",
"organisation_type": "Proprietary",
"date_of_incorporation": "2019-06-01",
"date_of_udyam_registration": "2020-07-15"
},
"enterprise_type": [
{
"classification_year": "2024-25",
"enterprise_type": "Micro"
}
],
"units_details": [
{
"unit_name": "Main unit",
"city": "Pune"
}
],
"official_address_of_enterprise": {
"flat_door_block_no": "12",
"road_street_lane": "Example Lane",
"city": "Pune",
"district": "Pune",
"state": "Maharashtra",
"pin": "411001"
},
"national_industry_classification_codes": [
{
"nic_code": "47190",
"activity": "Retail trade"
}
],
"pdf_url": "https://example.com/udyam/certificate.pdf"
}
}Response fields
| Field | Type | Description |
|---|---|---|
general_info | object | Core details of the registration. |
general_info.udyam_registration_number | string | The Udyam registration number. |
general_info.name_of_enterprise | string | Name of the enterprise. |
general_info.type_of_enterprise | string | Micro, small or medium. |
general_info.major_activity | string | Manufacturing, services or trading. |
general_info.organisation_type | string | Legal form of the enterprise. |
general_info.social_category | string | Social category of the owner. |
general_info.date_of_incorporation | string | Date the enterprise was incorporated. |
general_info.date_of_commencement_of_production_business | string | Date production or business began. |
general_info.date_of_udyam_registration | string | Date of Udyam registration. |
general_info.dic | string | District industries centre. |
general_info.msmedi | string | MSME development institute. |
enterprise_type | array | History of the enterprise's classification, year by year. |
units_details | array | The enterprise's units and where they are. |
official_address_of_enterprise | object | Official address of the enterprise. |
official_address_of_enterprise.flat_door_block_no | string | Flat, door or block number. |
official_address_of_enterprise.name_of_premises_building | string | Name of the premises or building. |
official_address_of_enterprise.village_town | string | Village or town. |
official_address_of_enterprise.block | string | Block. |
official_address_of_enterprise.road_street_lane | string | Road, street or lane. |
official_address_of_enterprise.city | string | City. |
official_address_of_enterprise.district | string | District. |
official_address_of_enterprise.state | string | State. |
official_address_of_enterprise.pin | string | Pincode. |
official_address_of_enterprise.mobile | string | Mobile number on the registration. |
official_address_of_enterprise.email | string | Email on the registration. |
national_industry_classification_codes | array | NIC activity codes of the enterprise. |
pdf_url | string | Link to the registration certificate as a PDF. |
Errors
Every failure has the same shape. A call that fails on our side or at the data source is refunded to your wallet; a "no record found" answer is charged. See the error reference.