Cashfree Payments Developer Documentation

Verify Udyam

curl --request POST \
  --url https://sandbox.cashfree.com/verification/udyam \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "verification_id": "tfqgzsXu3Z",
  "udyam": "UDYAM-UP-43-1234567"
}
'

{
  "verification_id": "tfqgzsXu3Z",
  "reference_id": 3478283,
  "status": "VALID",
  "udyam": "UDYAM-UP-43-1234567",
  "message": "Enterprise exists",
  "udyam_certificate_url": "https://galvatron-gridlines-io.s3.ap-south-1.amazonaws.com/udyam/certificates/3529462c-6ada-41be-9340-196044d91c63/2025_10_29/UDYAM-UP-43-1234567___fad87cba-e991-494a-8c52-062eb7aa4d34.pdf",
  "enterprise_data": {
    "document_id": "UDYAM-UP-43-1234567",
    "major_activity": "Services",
    "enterprise_type": "Micro",
    "classification_year": "2024-25",
    "classification_date": "2025-06-02T00:00:00.000Z",
    "organization_type": "Proprietary",
    "name": "John",
    "mobile": "98*****210",
    "email": "[email protected]",
    "address": {
      "door_no": "Ground Floor",
      "building": "05 Raman Vihar",
      "area": "Naubasta",
      "block": "Naubasta",
      "street": "Naubasta",
      "city": "Kanpur",
      "district": "KANPUR NAGAR",
      "state": "UTTAR PRADESH",
      "pincode": "208021"
    },
    "date_of_incorporation": "2020-05-29T00:00:00.000Z",
    "date_of_commencement": "2020-05-29T00:00:00.000Z",
    "date_of_udyam_registration": "2022-01-02T00:00:00.000Z",
    "dic": "KANPUR NAGAR",
    "msme_di": "KANPUR",
    "social_category": "General"
  },
  "enterprise_type_data": [
    {
      "enterprise_type": "Micro",
      "classification_year": "2024-25",
      "classification_date": "2025-06-02T00:00:00.000Z"
    },
    {
      "enterprise_type": "Micro",
      "classification_year": "2023-24",
      "classification_date": "2023-05-09T00:00:00.000Z"
    },
    {
      "enterprise_type": "Micro",
      "classification_year": "2022-23",
      "classification_date": "2022-06-26T00:00:00.000Z"
    },
    {
      "enterprise_type": "Micro",
      "classification_year": "2021-22",
      "classification_date": "2022-01-02T00:00:00.000Z"
    }
  ],
  "nic_data": {
    "nic_2_digit": "85 - Education",
    "nic_4_digit": "8550 - Educational support services",
    "nic_5_digit": "85500 - Educational support services"
  },
  "nic_data_list": [
    {
      "nic_2_digit": "85 - Education",
      "nic_4_digit": "8550 - Educational support services",
      "nic_5_digit": "85500 - Educational support services",
      "activity_type": "Services",
      "date": "2022-01-02T00:00:00.000Z"
    }
  ],
  "enterprise_units": [
    {
      "name": "John",
      "address": {
        "door_no": "Ground Floor",
        "building": "05 Raman Vihar Naubasta",
        "area": "KANPUR NAGAR",
        "block": "KANPUR NAGAR",
        "street": "05 Raman Vihar Naubasta Bamba",
        "city": "Kanpur",
        "district": "KANPUR NAGAR",
        "state": "UTTAR PRADESH",
        "pincode": "208021"
      }
    },
    {
      "name": "Josh",
      "address": {
        "door_no": "Ground Floor",
        "building": "05 Raman Vihar Naubasta",
        "area": "Kanpur",
        "block": "Kanpur",
        "street": "Kanpur",
        "city": "Kanpur",
        "district": "KANPUR NAGAR",
        "state": "UTTAR PRADESH",
        "pincode": "208021"
      }
    }
  ]
}

POST

udyam

Verify Udyam

curl --request POST \
  --url https://sandbox.cashfree.com/verification/udyam \
  --header 'Content-Type: application/json' \
  --header 'x-client-id: <api-key>' \
  --header 'x-client-secret: <api-key>' \
  --data '
{
  "verification_id": "tfqgzsXu3Z",
  "udyam": "UDYAM-UP-43-1234567"
}
'

{
  "verification_id": "tfqgzsXu3Z",
  "reference_id": 3478283,
  "status": "VALID",
  "udyam": "UDYAM-UP-43-1234567",
  "message": "Enterprise exists",
  "udyam_certificate_url": "https://galvatron-gridlines-io.s3.ap-south-1.amazonaws.com/udyam/certificates/3529462c-6ada-41be-9340-196044d91c63/2025_10_29/UDYAM-UP-43-1234567___fad87cba-e991-494a-8c52-062eb7aa4d34.pdf",
  "enterprise_data": {
    "document_id": "UDYAM-UP-43-1234567",
    "major_activity": "Services",
    "enterprise_type": "Micro",
    "classification_year": "2024-25",
    "classification_date": "2025-06-02T00:00:00.000Z",
    "organization_type": "Proprietary",
    "name": "John",
    "mobile": "98*****210",
    "email": "[email protected]",
    "address": {
      "door_no": "Ground Floor",
      "building": "05 Raman Vihar",
      "area": "Naubasta",
      "block": "Naubasta",
      "street": "Naubasta",
      "city": "Kanpur",
      "district": "KANPUR NAGAR",
      "state": "UTTAR PRADESH",
      "pincode": "208021"
    },
    "date_of_incorporation": "2020-05-29T00:00:00.000Z",
    "date_of_commencement": "2020-05-29T00:00:00.000Z",
    "date_of_udyam_registration": "2022-01-02T00:00:00.000Z",
    "dic": "KANPUR NAGAR",
    "msme_di": "KANPUR",
    "social_category": "General"
  },
  "enterprise_type_data": [
    {
      "enterprise_type": "Micro",
      "classification_year": "2024-25",
      "classification_date": "2025-06-02T00:00:00.000Z"
    },
    {
      "enterprise_type": "Micro",
      "classification_year": "2023-24",
      "classification_date": "2023-05-09T00:00:00.000Z"
    },
    {
      "enterprise_type": "Micro",
      "classification_year": "2022-23",
      "classification_date": "2022-06-26T00:00:00.000Z"
    },
    {
      "enterprise_type": "Micro",
      "classification_year": "2021-22",
      "classification_date": "2022-01-02T00:00:00.000Z"
    }
  ],
  "nic_data": {
    "nic_2_digit": "85 - Education",
    "nic_4_digit": "8550 - Educational support services",
    "nic_5_digit": "85500 - Educational support services"
  },
  "nic_data_list": [
    {
      "nic_2_digit": "85 - Education",
      "nic_4_digit": "8550 - Educational support services",
      "nic_5_digit": "85500 - Educational support services",
      "activity_type": "Services",
      "date": "2022-01-02T00:00:00.000Z"
    }
  ],
  "enterprise_units": [
    {
      "name": "John",
      "address": {
        "door_no": "Ground Floor",
        "building": "05 Raman Vihar Naubasta",
        "area": "KANPUR NAGAR",
        "block": "KANPUR NAGAR",
        "street": "05 Raman Vihar Naubasta Bamba",
        "city": "Kanpur",
        "district": "KANPUR NAGAR",
        "state": "UTTAR PRADESH",
        "pincode": "208021"
      }
    },
    {
      "name": "Josh",
      "address": {
        "door_no": "Ground Floor",
        "building": "05 Raman Vihar Naubasta",
        "area": "Kanpur",
        "block": "Kanpur",
        "street": "Kanpur",
        "city": "Kanpur",
        "district": "KANPUR NAGAR",
        "state": "UTTAR PRADESH",
        "pincode": "208021"
      }
    }
  ]
}

Authorizations

x-client-id

string

header

required

Your unique client identifier issued by Cashfree. You can find this in your Merchant Dashboard.

x-client-secret

string

header

required

The secret key associated with your client ID. Use this to authenticate your API requests. You can find this in your Merchant Dashboard.

Headers

x-cf-signature

string

Send the signature if two-factor authentication is selected as Public Key. More details

Body

application/json

Find the request parameters to retrieve the information of a Udyam number

verification_id

string

required

It is the unique ID you create to identify the verification request. The maximum character limit is 50. Alphanumeric, period (.), hyphen (-), and underscore ( _ ) are allowed.

Example:

"tfqgzsXu3Z"

udyam

string

required

It is the Udyam registration number to be verified.

Example:

"UDYAM-UP-43-1234567"

Response

Success response for Udyam verification.

verification_id

string

It displays the unique ID you created to identify the verification request.

Example:

"tfqgzsXu3Z"

reference_id

integer

It displays the unique ID created by Cashfree Payments for reference purposes.

Example:

3478283

status

string

It displays the status of the verification request. Possible values are VALID, INVALID.

Example:

"VALID"

udyam

string | null

It displays the Udyam registration number.

Example:

"UDYAM-UP-43-1234567"

message

string

It displays the verification message.

Example:

"Enterprise exists"

udyam_certificate_url

string | null

It displays the URL to download the Udyam certificate.

Example:

"https://galvatron-gridlines-io.s3.ap-south-1.amazonaws.com/udyam/certificates/3529462c-6ada-41be-9340-196044d91c63/2025_10_29/UDYAM-UP-43-1234567___fad87cba-e991-494a-8c52-062eb7aa4d34.pdf"

enterprise_data

object

It contains the enterprise information.

Show child attributes

enterprise_data.document_id

string

It displays the Udyam document ID.

Example:

"UDYAM-UP-43-1234567"

enterprise_data.major_activity

string

It displays the major activity of the enterprise.

Example:

"Services"

enterprise_data.enterprise_type

string

It displays the type of enterprise.

Example:

"Micro"

enterprise_data.classification_year

string

It displays the classification year.

Example:

"2024-25"

enterprise_data.classification_date

string

It displays the classification date.

Example:

"2025-06-02T00:00:00.000Z"

enterprise_data.organization_type

string

It displays the organization type.

Example:

"Proprietary"

enterprise_data.name

string

It displays the enterprise name.

Example:

"helloscholar"

enterprise_data.mobile

string

It displays the masked mobile number.

Example:

"70*****425"

enterprise_data.email

string

It displays the enterprise email.

Example:

"[email protected]"

enterprise_data.address

object

It contains the enterprise address information.

Show child attributes

enterprise_data.address.door_no

string

Example:

"Ground Floor"

enterprise_data.address.building

string

Example:

"05 Raman Vihar"

enterprise_data.address.area

string

Example:

"Naubasta"

enterprise_data.address.block

string

Example:

"Naubasta"

enterprise_data.address.street

string

Example:

"Naubasta"

enterprise_data.address.city

string

Example:

"Kanpur"

enterprise_data.address.district

string

Example:

"KANPUR NAGAR"

enterprise_data.address.state

string

Example:

"UTTAR PRADESH"

enterprise_data.address.pincode

string

Example:

208021

enterprise_data.date_of_incorporation

string

It displays the date of incorporation.

Example:

"2020-05-29T00:00:00.000Z"

enterprise_data.date_of_commencement

string

It displays the date of commencement.

Example:

"2020-05-29T00:00:00.000Z"

enterprise_data.date_of_udyam_registration

string

It displays the date of Udyam registration.

Example:

"2022-01-02T00:00:00.000Z"

enterprise_data.dic

string

It displays the DIC.

Example:

"KANPUR NAGAR"

enterprise_data.msme_di

string

It displays the MSME DI.

Example:

"KANPUR"

It displays the social category.

Example:

"General"

enterprise_type_data

object[]

It contains the enterprise type data for different years.

Show child attributes

enterprise_type_data.enterprise_type

string

Example:

"Micro"

enterprise_type_data.classification_year

string

Example:

"2024-25"

enterprise_type_data.classification_date

string

Example:

"2025-06-02T00:00:00.000Z"

nic_data

object

It contains the NIC data information.

Show child attributes

nic_data.nic_2_digit

string

Example:

"85 - Education"

nic_data.nic_4_digit

string

Example:

"8550 - Educational support services"

nic_data.nic_5_digit

string

Example:

"85500 - Educational support services"

nic_data_list

object[]

It contains the list of NIC data.

Show child attributes

nic_data_list.nic_2_digit

string

Example:

"85 - Education"

nic_data_list.nic_4_digit

string

Example:

"8550 - Educational support services"

nic_data_list.nic_5_digit

string

Example:

"85500 - Educational support services"

nic_data_list.activity_type

string

Example:

"Services"

nic_data_list.date

string

Example:

"2022-01-02T00:00:00.000Z"

enterprise_units

object[]

It contains the list of enterprise units.

Show child attributes

enterprise_units.name

string

Example:

"hellobanker"

enterprise_units.address

object

Show child attributes

enterprise_units.address.door_no

string

Example:

"Ground Floor"

enterprise_units.address.building

string

Example:

"05 Raman Vihar Naubasta"

enterprise_units.address.area

string

Example:

"KANPUR NAGAR"

enterprise_units.address.block

string

Example:

"KANPUR NAGAR"

enterprise_units.address.street

string

Example:

"05 Raman Vihar Naubasta Bamba"

enterprise_units.address.city

string

Example:

"Kanpur"

enterprise_units.address.district

string

Example:

"KANPUR NAGAR"

enterprise_units.address.state

string

Example:

"UTTAR PRADESH"

enterprise_units.address.pincode

string

Example:

208021

Verify CIN Fetch Udyam with PAN

⌘I

Secure ID APIs

V2

V1 (Depricated API's)

Verify Udyam

Authorizations

Headers

Body

Response