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

FieldTypeRequiredDescription
udyam_numberstringYesUdyam 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

FieldTypeDescription
general_infoobjectCore details of the registration.
general_info.udyam_registration_numberstringThe Udyam registration number.
general_info.name_of_enterprisestringName of the enterprise.
general_info.type_of_enterprisestringMicro, small or medium.
general_info.major_activitystringManufacturing, services or trading.
general_info.organisation_typestringLegal form of the enterprise.
general_info.social_categorystringSocial category of the owner.
general_info.date_of_incorporationstringDate the enterprise was incorporated.
general_info.date_of_commencement_of_production_businessstringDate production or business began.
general_info.date_of_udyam_registrationstringDate of Udyam registration.
general_info.dicstringDistrict industries centre.
general_info.msmedistringMSME development institute.
enterprise_typearrayHistory of the enterprise's classification, year by year.
units_detailsarrayThe enterprise's units and where they are.
official_address_of_enterpriseobjectOfficial address of the enterprise.
official_address_of_enterprise.flat_door_block_nostringFlat, door or block number.
official_address_of_enterprise.name_of_premises_buildingstringName of the premises or building.
official_address_of_enterprise.village_townstringVillage or town.
official_address_of_enterprise.blockstringBlock.
official_address_of_enterprise.road_street_lanestringRoad, street or lane.
official_address_of_enterprise.citystringCity.
official_address_of_enterprise.districtstringDistrict.
official_address_of_enterprise.statestringState.
official_address_of_enterprise.pinstringPincode.
official_address_of_enterprise.mobilestringMobile number on the registration.
official_address_of_enterprise.emailstringEmail on the registration.
national_industry_classification_codesarrayNIC activity codes of the enterprise.
pdf_urlstringLink 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.