Verify Udyam

Use this API to verify an Udyam registration using the Udyam reference number. For a valid registration, the response returns enterprise details such as NIC classification and enterprise unit information.

View the test data and use the information to trigger the validations. The test data can be used only in the sandbox environment.

POST /udyam

Verify Udyam

cURL

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"
}
'

import requests

url = "https://sandbox.cashfree.com/verification/udyam"

payload = {
    "verification_id": "tfqgzsXu3Z",
    "udyam": "UDYAM-UP-43-1234567"
}
headers = {
    "x-client-id": "<api-key>",
    "x-client-secret": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'x-client-id': '<api-key>',
    'x-client-secret': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({verification_id: 'tfqgzsXu3Z', udyam: 'UDYAM-UP-43-1234567'})
};

fetch('https://sandbox.cashfree.com/verification/udyam', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://sandbox.cashfree.com/verification/udyam",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'verification_id' => 'tfqgzsXu3Z',
    'udyam' => 'UDYAM-UP-43-1234567'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "x-client-id: <api-key>",
    "x-client-secret: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://sandbox.cashfree.com/verification/udyam"

	payload := strings.NewReader("{\n  \"verification_id\": \"tfqgzsXu3Z\",\n  \"udyam\": \"UDYAM-UP-43-1234567\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("x-client-id", "<api-key>")
	req.Header.Add("x-client-secret", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://sandbox.cashfree.com/verification/udyam")
  .header("x-client-id", "<api-key>")
  .header("x-client-secret", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"verification_id\": \"tfqgzsXu3Z\",\n  \"udyam\": \"UDYAM-UP-43-1234567\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://sandbox.cashfree.com/verification/udyam")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["x-client-id"] = '<api-key>'
request["x-client-secret"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"verification_id\": \"tfqgzsXu3Z\",\n  \"udyam\": \"UDYAM-UP-43-1234567\"\n}"

response = http.request(request)
puts response.read_body

200

SUCCESS

{
  "verification_id": "tfqgzsXu3Z",
  "reference_id": 3478283,
  "status": "SUCCESS",
  "udyam_number": "UDYAM-UP-43-1234567",
  "enterprise_name": "helloscholar",
  "organization_type": "Proprietary",
  "major_activity": "Services",
  "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",
      "classification_year": "2024-25",
      "enterprise_type": "Micro",
      "classification_date": "2025-06-02"
    },
    {
      "serial_number": "2",
      "classification_year": "2023-24",
      "enterprise_type": "Micro",
      "classification_date": "2023-05-09"
    },
    {
      "serial_number": "3",
      "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": "[e-mail]"
  },
  "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"
}

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

200

application/json

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"

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"

social_category · string | null

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

split_address · object | null

It contains the enterprise address information.

Show child attributes

unit_locations · object[]

It contains the list of enterprise unit locations.

Show child attributes

nic_codes · object[]

It contains the NIC codes information.

Show child attributes

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"