Name To CIN

Endpoint Overview

POST /api/v1/corporate/name-to-cin-list

Description

This API enables you to search for companies by name and retrieve detailed information about matching companies. It returns a list of companies with their Corporate Identification Numbers (CIN), official registered names, and company types. This endpoint is particularly useful for verifying company existence, obtaining official registration details, and streamlining corporate KYC processes.

Key Benefits

Quickly validate company existence and retrieve official registration details

Obtain accurate CIN numbers for corporate verification workflows

Identify company type (Private Limited, LLP, etc.) for compliance and onboarding processes

Simplify corporate KYC with reliable government-registered information

Use Cases

Financial Services

B2B Services

Compliance & Legal

Verify corporate clients during account opening processes

Validate company details before extending credit or loans

Streamline corporate KYC and due diligence workflows

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 for authentication (JWT format)
Content-Type	Yes	application/json

Request Body

Parameter	Type	Required	Description
company_name_search	String	Yes	The company name to search for

Example Request

{
    "company_name_search": "Zucol"
}

Process Response

Response Parameters

Parameter	Type	Description
data	Object	Contains the response data
data.client_id	String	Unique identifier for the API request
data.company_name_search	String	The company name that was searched
data.company_list	Array	List of companies matching the search criteria
data.company_list[].cin_number	String	Corporate Identification Number of the company
data.company_list[].company_name	String	Official registered name of the company
data.company_list[].company_type	String	Type of company (llp, opc, pvt_ltd, ltd, other)
status_code	Integer	HTTP status code of the response
success	Boolean	Indicates if the request was successful
message	String	Additional message (null if successful)
message_code	String	Code indicating the status of the request

Example Successful Response

{
    "data": {
        "client_id": "corporate_name_list_cdeKzMoltWosnhkeOmvs",
        "company_name_search": "Zucol",
        "company_list": [
            {
                "cin_number": "U74995RJ2018PTC0123456",
                "company_name": "ZUCOL SERVICES PRIVATE LIMITED",
                "company_type": "pvt_ltd"
            },
            {
                "cin_number": "U74999RJ2019PTC0987456",
                "company_name": "ZUCOL SOLUTIONS PRIVATE LIMITED",
                "company_type": "pvt_ltd"
            },
            {
                "cin_number": "ACE-1234",
                "company_name": "ZUCOL WEALTH SOLUTIONS LLP",
                "company_type": "llp"
            }
        ]
    },
    "status_code": 200,
    "success": true,
    "message": null,
    "message_code": "success"
}

Possible Error Responses

Authentication Error

Invalid Input

No Results Found

{
    "status_code": 401,
    "success": false,
    "message": "Invalid or expired token",
    "message_code": "unauthorized"
}

This error occurs when the JWT token is missing, invalid, or expired.

Integration Best Practices

Security Recommendations

Store JWT tokens securely and never expose them in client-side code

Implement token refresh mechanisms to handle token expiration

Use HTTPS for all API communications to ensure data encryption

Implement proper error handling for authentication failures

User Experience Guidelines

Implement partial matching to improve search results (the API will return partial matches)

Display company type in a user-friendly format (e.g., "Private Limited" instead of "pvt_ltd")

Provide clear feedback when no companies match the search criteria

Consider implementing type-ahead suggestions for company names to improve user experience

Code Samples

cURL

Python

Node.js

Related APIs

Company CIN Verification API: Verify company details using a specific CIN number

Company Director Information API: Retrieve information about company directors

Company Financial Information API: Access financial data for registered companies

Compliance and Legal Considerations

The data provided by this API is sourced from official government registries. While using this API for KYC and verification purposes, ensure you comply with relevant data protection regulations and maintain proper audit trails of verification processes. The company information should be used in accordance with applicable laws and regulations governing corporate data usage.

{ "data": { "client_id": "corporate_name_list_cdeKzMoltWosnhkeOmvs", "company_name_search": "Zucol", "company_list": [ { "cin_number": "U74995RJ2018PTC0123456", "company_name": "ZUCOL SERVICES PRIVATE LIMITED", "company_type": "pvt_ltd" }, { "cin_number": "U74999RJ2019PTC0987456", "company_name": "ZUCOL SOLUTIONS PRIVATE LIMITED", "company_type": "pvt_ltd" }, { "cin_number": "ACE-1234", "company_name": "ZUCOL WEALTH SOLUTIONS LLP", "company_type": "llp" } ] }, "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 ********************

Name To CIN

Name To CIN#

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

Name To CIN

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples