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": "SUCCESS",
  "udyam_number": "UDYAM-UP-43-1234567",
  "enterprise_name": "helloscholar",
  "owner_name": "John Doe",
  "organization_type": "Proprietary",
  "major_activity": "Services",
  "gender": "Male",
  "social_category": "General",
  "date_of_incorporation": "2020-05-29",
  "date_of_commencement": "2020-05-29",
  "date_of_udyam_registration": "2022-01-02",
  "enterprise_type": "Micro",
  "classification_year": "2024-25",
  "classification_date": "2025-06-02",
  "udyam_certificate_url": "UDYAM_CERTIFICATE_PDF_URL",
  "classification_history": [
    {
      "serial_number": "1",
      "data_year": "2023-24",
      "classification_year": "2024-25",
      "enterprise_type": "Micro",
      "classification_date": "2025-06-02"
    },
    {
      "serial_number": "2",
      "data_year": "2022-23",
      "classification_year": "2023-24",
      "enterprise_type": "Micro",
      "classification_date": "2023-05-09"
    },
    {
      "serial_number": "3",
      "data_year": "2022-23",
      "classification_year": "2022-23",
      "enterprise_type": "Micro",
      "classification_date": "2022-06-26"
    }
  ],
  "split_address": {
    "flat": "Ground Floor",
    "building": "05 Raman Vihar",
    "village": "Naubasta",
    "block": "Naubasta",
    "street": "Naubasta",
    "city": "Kanpur",
    "district": "KANPUR NAGAR",
    "state": "UTTAR PRADESH",
    "pincode": "208021",
    "mobile": "70*****210",
    "email": "[email protected]"
  },
  "unit_locations": [
    {
      "serial_number": "1",
      "unit_name": "hellobanker",
      "flat": "Ground Floor",
      "building": "05 Raman Vihar Naubasta",
      "village": "KANPUR NAGAR",
      "block": "KANPUR NAGAR",
      "street": "05 Raman Vihar Naubasta Bamba",
      "city": "Kanpur",
      "district": "KANPUR NAGAR",
      "state": "UTTAR PRADESH",
      "pincode": "208021"
    },
    {
      "serial_number": "2",
      "unit_name": "helloscholar",
      "flat": "Ground Floor",
      "building": "05 Raman Vihar Naubasta",
      "village": "Kanpur",
      "block": "Kanpur",
      "street": "Kanpur",
      "city": "Kanpur",
      "district": "KANPUR NAGAR",
      "state": "UTTAR PRADESH",
      "pincode": "208021"
    }
  ],
  "nic_codes": [
    {
      "serial_number": "1",
      "nic_2_digit": "85",
      "nic_2_description": "Education",
      "nic_4_digit": "8550",
      "nic_4_description": "Educational support services",
      "nic_5_digit": "85500",
      "nic_5_description": "Educational support services",
      "activity": "Services",
      "date": "2022-01-02"
    }
  ],
  "dic": "KANPUR NAGAR",
  "msme_di": "KANPUR",
  "msme_dfo": "KANPUR"
}

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": "SUCCESS",
  "udyam_number": "UDYAM-UP-43-1234567",
  "enterprise_name": "helloscholar",
  "owner_name": "John Doe",
  "organization_type": "Proprietary",
  "major_activity": "Services",
  "gender": "Male",
  "social_category": "General",
  "date_of_incorporation": "2020-05-29",
  "date_of_commencement": "2020-05-29",
  "date_of_udyam_registration": "2022-01-02",
  "enterprise_type": "Micro",
  "classification_year": "2024-25",
  "classification_date": "2025-06-02",
  "udyam_certificate_url": "UDYAM_CERTIFICATE_PDF_URL",
  "classification_history": [
    {
      "serial_number": "1",
      "data_year": "2023-24",
      "classification_year": "2024-25",
      "enterprise_type": "Micro",
      "classification_date": "2025-06-02"
    },
    {
      "serial_number": "2",
      "data_year": "2022-23",
      "classification_year": "2023-24",
      "enterprise_type": "Micro",
      "classification_date": "2023-05-09"
    },
    {
      "serial_number": "3",
      "data_year": "2022-23",
      "classification_year": "2022-23",
      "enterprise_type": "Micro",
      "classification_date": "2022-06-26"
    }
  ],
  "split_address": {
    "flat": "Ground Floor",
    "building": "05 Raman Vihar",
    "village": "Naubasta",
    "block": "Naubasta",
    "street": "Naubasta",
    "city": "Kanpur",
    "district": "KANPUR NAGAR",
    "state": "UTTAR PRADESH",
    "pincode": "208021",
    "mobile": "70*****210",
    "email": "[email protected]"
  },
  "unit_locations": [
    {
      "serial_number": "1",
      "unit_name": "hellobanker",
      "flat": "Ground Floor",
      "building": "05 Raman Vihar Naubasta",
      "village": "KANPUR NAGAR",
      "block": "KANPUR NAGAR",
      "street": "05 Raman Vihar Naubasta Bamba",
      "city": "Kanpur",
      "district": "KANPUR NAGAR",
      "state": "UTTAR PRADESH",
      "pincode": "208021"
    },
    {
      "serial_number": "2",
      "unit_name": "helloscholar",
      "flat": "Ground Floor",
      "building": "05 Raman Vihar Naubasta",
      "village": "Kanpur",
      "block": "Kanpur",
      "street": "Kanpur",
      "city": "Kanpur",
      "district": "KANPUR NAGAR",
      "state": "UTTAR PRADESH",
      "pincode": "208021"
    }
  ],
  "nic_codes": [
    {
      "serial_number": "1",
      "nic_2_digit": "85",
      "nic_2_description": "Education",
      "nic_4_digit": "8550",
      "nic_4_description": "Educational support services",
      "nic_5_digit": "85500",
      "nic_5_description": "Educational support services",
      "activity": "Services",
      "date": "2022-01-02"
    }
  ],
  "dic": "KANPUR NAGAR",
  "msme_di": "KANPUR",
  "msme_dfo": "KANPUR"
}

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

enum<string>

It displays the status of the verification request.

Available options:

SUCCESS,

UDYAM_NOT_FOUND,

UDYAM_IS_CANCELLED

Example:

"SUCCESS"

udyam_number

string | null

It displays the Udyam registration number.

Example:

"UDYAM-UP-43-1234567"

enterprise_name

string | null

It displays the enterprise name.

Example:

"helloscholar"

owner_name

string | null

It displays the owner name.

Example:

"John Doe"

organization_type

string | null

It displays the organization type.

Example:

"Proprietary"

major_activity

string | null

It displays the major activity of the enterprise.

Example:

"Services"

gender

string | null

It displays the gender.

Example:

"Male"

It displays the social category.

Example:

"General"

date_of_incorporation

string | null

It displays the date of incorporation.

Example:

"2020-05-29"

date_of_commencement

string | null

It displays the date of commencement.

Example:

"2020-05-29"

date_of_udyam_registration

string | null

It displays the date of Udyam registration.

Example:

"2022-01-02"

enterprise_type

string | null

It displays the type of enterprise.

Example:

"Micro"

classification_year

string | null

It displays the classification year.

Example:

"2024-25"

classification_date

string | null

It displays the classification date.

Example:

"2025-06-02"

udyam_certificate_url

string | null

It displays the URL to download the Udyam certificate.

Example:

"UDYAM_CERTIFICATE_PDF_URL"

classification_history

object[]

It contains the classification history for different years.

Show child attributes

classification_history.serial_number

string

Example:

"1"

classification_history.data_year

string | null

Example:

"2024-25"

classification_history.classification_year

string

Example:

"2024-25"

classification_history.enterprise_type

string

Example:

"Micro"

classification_history.classification_date

string

Example:

"2025-06-02"

split_address

object

It contains the enterprise address information.

Show child attributes

split_address.flat

string

Example:

"Ground Floor"

split_address.building

string

Example:

"05 Raman Vihar"

split_address.village

string

Example:

"Naubasta"

split_address.block

string

Example:

"Naubasta"

split_address.street

string

Example:

"Naubasta"

split_address.city

string

Example:

"Kanpur"

split_address.district

string

Example:

"KANPUR NAGAR"

split_address.state

string

Example:

"UTTAR PRADESH"

split_address.pincode

string

Example:

"208021"

split_address.mobile

string

It displays the masked mobile number.

Example:

"70*****210"

split_address.email

string

It displays the enterprise email.

Example:

"[email protected]"

unit_locations

object[]

It contains the list of enterprise unit locations.

Show child attributes

unit_locations.serial_number

string

Example:

"1"

unit_locations.unit_name

string

Example:

"hellobanker"

unit_locations.flat

string

Example:

"Ground Floor"

unit_locations.building

string

Example:

"05 Raman Vihar Naubasta"

unit_locations.village

string

Example:

"KANPUR NAGAR"

unit_locations.block

string

Example:

"KANPUR NAGAR"

unit_locations.street

string

Example:

"05 Raman Vihar Naubasta Bamba"

unit_locations.city

string

Example:

"Kanpur"

unit_locations.district

string

Example:

"KANPUR NAGAR"

unit_locations.state

string

Example:

"UTTAR PRADESH"

unit_locations.pincode

string

Example:

"208021"

nic_codes

object[]

It contains the NIC codes information.

Show child attributes

nic_codes.serial_number

string

Example:

"1"

nic_codes.nic_2_digit

string

Example:

"85"

nic_codes.nic_2_description

string

Example:

"Education"

nic_codes.nic_4_digit

string

Example:

"8550"

nic_codes.nic_4_description

string

Example:

"Educational support services"

nic_codes.nic_5_digit

string

Example:

"85500"

nic_codes.nic_5_description

string

Example:

"Educational support services"

nic_codes.activity

string

Example:

"Services"

nic_codes.date

string

Example:

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

dic

string | null

It displays the DIC (District Industries Centre).

Example:

"KANPUR NAGAR"

msme_di

string | null

It displays the MSME DI (Development Institute).

Example:

"KANPUR"

msme_dfo

string | null

It displays the MSME DFO (Development Field Officer).

Example:

"KANPUR"

Verify CIN Fetch Udyam with PAN

⌘I

Secure ID APIs

V2

V1 (Depricated API's)

Verify Udyam

Authorizations

Headers

Body

Response