PAN to MSME Status

Endpoint Overview

POST /api/v1/pan-to-msme/status

Description

The PAN to MSME Status API enables businesses and developers to retrieve comprehensive MSME (Micro, Small, and Medium Enterprises) registration details using a PAN (Permanent Account Number) as the identifier. This endpoint provides access to Udyam registration information, enterprise classification, industry details, and branch addresses associated with a specific PAN.

The API returns a status field that indicates the processing result with four possible values: pending (request is being processed), success (data retrieved successfully), invalid (invalid PAN or request parameters), and failed (processing failed due to system or data issues).

This API streamlines the process of verifying MSME credentials and obtaining detailed enterprise information for compliance, onboarding, and business verification purposes. It serves as a bridge between PAN-based identification and comprehensive MSME enterprise data.

Key Benefits

Comprehensive Enterprise Data: Access complete MSME registration details including Udyam number, enterprise type, and industry classifications

Multi-Branch Information: Retrieve all registered branch addresses and locations for comprehensive business mapping

Regulatory Compliance: Ensure compliance with MSME verification requirements for lending, procurement, and business partnerships

Streamlined Onboarding: Accelerate customer onboarding processes by automatically fetching verified enterprise information

Use Cases

Financial Services

Procurement & Supply Chain

Business Services

Loan Application Processing: Verify MSME status for priority sector lending and government scheme eligibility

Credit Assessment: Access enterprise details and business activity information for risk evaluation

KYB (Know Your Business): Complete business verification during account opening and financial service provisioning

Government Scheme Verification: Validate MSME credentials for accessing government-backed financial products

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.app

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

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer JWT token for API authentication
Content-Type	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
client_id	String	Yes	Unique client identifier for the PAN to MSME status request. Format: `pan_to_msme_` followed by alphanumeric characters

Example Request

{
    "client_id": "pan_to_msme_qHSovVUTKbdXtHctufdD"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Container object holding all MSME enterprise information
data.client_id	String	Echo of the client_id from the request
data.pan	String	PAN number associated with the enterprise
data.status	String	Status of the request processing (success/failure)
data.enterprise_details	Object	Comprehensive enterprise information including registration and contact details
data.enterprise_details.udyam_registration_number	String	Unique Udyam registration number
data.enterprise_details.major_activity	String	Primary business activity category
data.enterprise_details.enterprise_type	String	Classification as Micro/Small/Medium enterprise
data.enterprise_details.organization_type	String	Legal structure of the organization
data.enterprise_details.company_name	String	Registered name of the enterprise
data.enterprise_details.phone_number	String	Registered contact phone number (partially masked)
data.enterprise_details.company_email	String	Registered email address
data.enterprise_details.date_of_incorporation	String	Date when the company was incorporated (YYYY-MM-DD)
data.enterprise_details.date_of_commencement	String	Date when business operations commenced (YYYY-MM-DD)
data.enterprise_details.registration_date	String	Udyam registration date (YYYY-MM-DD)
data.enterprise_details.district_industries_center	String	Registered district industries center
data.enterprise_details.dfo	String	District Field Office location
data.enterprise_details.social_category	String	Social category classification
data.enterprise_details.official_address	Object	Registered office address details
data.industry_details	Array	List of industry classifications and activity codes
data.branch_address	Array	List of all registered branch locations
data.link	String	Direct link to the official MSME certificate document
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates whether the request was successful
message	String	Human-readable status message
message_code	String	Machine-readable message code

Example Successful Response

{
    "data": {
        "client_id": "pan_to_msme_qHSovVUTKbdXtHctufdD",
        "pan": "ABCDE1234F",
        "status": "success",
        "enterprise_details": {
            "udyam_registration_number": "UDYAM-XX-99-0000000",
            "major_activity": "Retail",
            "enterprise_type": "Small",
            "organization_type": "Private Limited Company",
            "company_name": "Mock Enterprises Private Limited",
            "phone_number": "99*****123",
            "company_email": "contact@mockenterprises.com",
            "date_of_incorporation": "2015-05-01",
            "date_of_commencement": "2016-07-01",
            "registration_date": "2023-08-15",
            "district_industries_center": "MUMBAI",
            "dfo": "MUMBAI",
            "social_category": "GEN",
            "official_address": {
                "door_no": "Flat No. 101",
                "building": "Mock Towers",
                "area": "Cyber Park",
                "block": "Block B",
                "street": "Silicon Street",
                "city": "Mumbai",
                "district": "MUMBAI",
                "state": "MAHARASHTRA",
                "pincode": "400001"
            }
        },
        "industry_details": [
            {
                "industry_code": "47 - Retail trade",
                "sub_sector_code": "4779 - Other retail trade",
                "branch_sub_sector_code": "47790 - Other retail trade",
                "activity_type": "Retail",
                "date": "2023-08-15"
            },
            {
                "industry_code": "70 - Activities of head offices",
                "sub_sector_code": "7010 - Activities of head offices",
                "branch_sub_sector_code": "70100 - Activities of head offices",
                "activity_type": "Services",
                "date": "2023-08-15"
            }
        ],
        "branch_address": [
            {
                "name": "Mock Enterprises Private Limited",
                "address": {
                    "door_no": "Block No. 5",
                    "building": "Mock Towers",
                    "area": "Silicon Valley",
                    "block": "Block A",
                    "street": "Tech Road",
                    "city": "Pune",
                    "district": "PUNE",
                    "state": "MAHARASHTRA",
                    "pincode": "411001"
                }
            },
            {
                "name": "Mock Enterprises Private Limited",
                "address": {
                    "door_no": "2nd Floor",
                    "building": "Global Building",
                    "area": "Downtown Area",
                    "block": "C Block",
                    "street": "Main Street",
                    "city": "Bangalore",
                    "district": "BANGALORE",
                    "state": "KARNATAKA",
                    "pincode": "560001"
                }
            }
        ],
        "link": "https://mockdomain.com/mockfile.pdf?mockparams=abcdef123456"
    },
    "status_code": 200,
    "success": true,
    "message": "Success",
    "message_code": "success"
}

Possible Error Responses

Invalid Client ID

Authentication Error

{
    "data": null,
    "status_code": 400,
    "success": false,
    "message": "Invalid client_id format",
    "message_code": "invalid_client_id"
}

Occurs when the client_id parameter is missing, empty, or doesn't follow the expected format.

Integration Best Practices

Security Recommendations

Token Management: Store JWT tokens securely and implement automatic token refresh mechanisms

Environment Isolation: Use separate API keys and tokens for sandbox and production environments

Request Validation: Validate client_id format before making API calls to prevent unnecessary requests

Data Protection: Implement proper data handling procedures for sensitive enterprise information received in responses

User Experience Guidelines

Loading States: Display appropriate loading indicators during API requests as responses may contain substantial data

Error Handling: Implement user-friendly error messages for different failure scenarios (PAN not found, invalid format, etc.)

Data Presentation: Organize the comprehensive response data in a structured, easily digestible format for end users

Performance Optimization: Cache successful responses where appropriate to reduce API calls and improve response times

Code Samples

cURL

Python

Node.js

Related APIs

PAN Verification API: Validate PAN numbers and retrieve basic holder information

GSTIN to PAN API: Cross-reference GSTIN with PAN for comprehensive business verification

Company Search API: Search and verify company information using various identifiers

Address Verification API: Validate and standardize address information from enterprise data

Compliance and Legal Considerations

Data Privacy: Ensure compliance with applicable data protection regulations when handling enterprise information

MSME Act Compliance: Verify that usage aligns with MSME Development Act provisions and regulations

Information Accuracy: While the API provides official government data, users should verify critical information through multiple sources for high-stakes decisions

Usage Limitations: Respect rate limits and use data responsibly in accordance with Surepass terms of service and government data usage policies

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/pan-to-msme/status' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "client_id": "pan_to_msme_qHSovVUTKbdXtHctufdD" }'

{ "data": { "client_id": "pan_to_msme_qHSovVUTKbdXtHctufdD", "pan": "ABCDE1234F", "status": "success", "enterprise_details": { "udyam_registration_number": "UDYAM-XX-99-0000000", "major_activity": "Retail", "enterprise_type": "Small", "organization_type": "Private Limited Company", "company_name": "Mock Enterprises Private Limited", "phone_number": "99*****123", "company_email": "contact@mockenterprises.com", "date_of_incorporation": "2015-05-01", "date_of_commencement": "2016-07-01", "registration_date": "2023-08-15", "district_industries_center": "MUMBAI", "dfo": "MUMBAI", "social_category": "GEN", "official_address": { "door_no": "Flat No. 101", "building": "Mock Towers", "area": "Cyber Park", "block": "Block B", "street": "Silicon Street", "city": "Mumbai", "district": "MUMBAI", "state": "MAHARASHTRA", "pincode": "400001" } }, "industry_details": [ { "industry_code": "47 - Retail trade", "sub_sector_code": "4779 - Other retail trade", "branch_sub_sector_code": "47790 - Other retail trade", "activity_type": "Retail", "date": "2023-08-15" }, { "industry_code": "70 - Activities of head offices", "sub_sector_code": "7010 - Activities of head offices", "branch_sub_sector_code": "70100 - Activities of head offices", "activity_type": "Services", "date": "2023-08-15" } ], "branch_address": [ { "name": "Mock Enterprises Private Limited", "address": { "door_no": "Block No. 5", "building": "Mock Towers", "area": "Silicon Valley", "block": "Block A", "street": "Tech Road", "city": "Pune", "district": "PUNE", "state": "MAHARASHTRA", "pincode": "411001" } }, { "name": "Mock Enterprises Private Limited", "address": { "door_no": "2nd Floor", "building": "Global Building", "area": "Downtown Area", "block": "C Block", "street": "Main Street", "city": "Bangalore", "district": "BANGALORE", "state": "KARNATAKA", "pincode": "560001" } } ], "link": "https://mockdomain.com/mockfile.pdf?mockparams=abcdef123456" }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Status

PAN to MSME Status#

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