PAN Udyam Check

Endpoint Overview

POST /api/v1/corporate/pan-udyam-check

Description

The PAN Udyam Check API allows you to verify whether a business entity has registered under the Udyam Registration system using their PAN details. This endpoint validates if a business has migrated from the older MSME registration system to the new Udyam portal, which is essential for businesses to access government schemes and benefits for MSMEs (Micro, Small, and Medium Enterprises) in India.

Key Benefits

Instant verification of Udyam registration status linked to a PAN

Confirmation of migration status from older MSME registration to Udyam portal

Streamlined KYC process for business entities

Reduced manual verification overhead for MSME-focused services

Use Cases

Financial Services

Government Services

B2B Platforms

Verify MSME status before extending specialized credit facilities

Validate eligibility for priority sector lending

Confirm business identity during corporate account opening

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.io

Production: https://kyc-api.surepass.io

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token authentication using JWT
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
pan_number	String	Yes	PAN Number of the business entity
full_name	String	Yes	Full name of the business entity
dob	String	Yes	Date of incorporation in "YYYY-MM-DD" format

Example Request

{
    "pan_number": "ABBCS1234D",
    "full_name": "SURJAL PRIVATE LIMITED",
    "dob": "2018-11-15"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container for the response data
data.client_id	String	Unique identifier for the verification request
data.pan_number	String	PAN number that was verified
data.udyam_exists	Boolean	Indicates whether Udyam registration exists for the PAN
data.migration_status	String	Status of migration from old MSME system to Udyam portal (values: "migrated" or "not_migrated")
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the API call was successful
message	String or null	Additional information about the response (if any)
message_code	String	Code indicating the status of the request

Example Successful Response

{
    "data": {
        "client_id": "pan_udyam_check_nlGIZduXrlnwWuYfbznH",
        "pan_number": "ABBCS1234D",
        "udyam_exists": true,
        "migration_status": "migrated"
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Invalid PAN

Authentication Error

Missing Parameters

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "Invalid PAN number format",
    "message_code": "invalid_pan_format"
}

The PAN number provided does not match the required format for Indian PAN cards.

Integration Best Practices

Security Recommendations

Store API credentials securely and never expose them in client-side code

Implement proper error handling to avoid exposing sensitive information

Rotate JWT tokens periodically and don't reuse them across different environments

Implement IP whitelisting for production environments when possible

User Experience Guidelines

Implement proper validation for PAN format before making API calls

Display clear error messages to users when verification fails

Implement retry mechanisms with exponential backoff for temporary failures

Cache successful verification results to reduce redundant API calls

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Validates PAN details against government records

Business Verification API: Comprehensive verification of business entities

GST Verification API: Validates GST registration details

Director KYC API: Verifies director information for corporate entities

Compliance and Legal Considerations

This API accesses government MSME registration data. Ensure you have proper consent from the business entity before performing verification. The data should be used in compliance with relevant data protection regulations and should not be stored longer than necessary for your business purpose. Usage of this API for mass scraping of MSME data is prohibited.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/corporate/pan-udyam-check' \ --header 'Content-Type: application/json' \ --data-raw '{ "pan_number": "ABBCS1234D", "full_name": "SURJAL PRIVATE LIMITED", "dob": "2018-11-15" }'

{ "data": { "client_id": "pan_udyam_check_nlGIZduXrlnwWuYfbznH", "pan_number": "ABBCS1234D", "udyam_exists": true, "migration_status": "migrated" }, "status_code": 200, "success": true, "message": null, "message_code": "success" }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

PAN Udyam Check

PAN Udyam Check#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

PAN Udyam Check

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples