Skip to main content
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"
}
'
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
{
  "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": "helloscholar.edu@gmail.com"
  },
  "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

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.

split_address
object | null

It contains the enterprise address information.

unit_locations
object[]

It contains the list of enterprise unit locations.

nic_codes
object[]

It contains the NIC codes information.

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"