Company AutoComplete

Endpoint Overview

GET /api/v1/corporate/company-autofill

Description

This API endpoint provides an autocomplete functionality for company names, returning matching company details based on a partial company name input. The endpoint searches across both registered companies and Limited Liability Partnerships (LLPs) in India, returning key identifiers including the Company Identification Number (CIN) or LLP identification number, company category, and the full registered company name.

Key Benefits

Simplifies company search with partial name matching

Returns both company and LLP entities in a single query

Provides official registration identifiers (CIN/LLP numbers)

Enables efficient company verification workflows

Use Cases

Financial Services

Compliance

Business Services

KYC verification during corporate account opening

Pre-filling company details in loan applications

Validating business entity details during onboarding

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
company_name	String	Yes	Partial company name to search for matches

Example Request

{
  "company_name": "RELIA"
}

Process Response

Response Parameters

Parameter	Type	Description
message	String	Status message of the request
data	Array	List of matching company records
data[].cin	String	Company Identification Number (CIN) or LLP identification number
data[].category	String	Entity type (COMPANY or LLP)
data[].company_name	String	Full registered name of the company or LLP
message_code	String	Code indicating the status of the request
status_code	Integer	HTTP status code
success	Boolean	Indicates if the request was successful

Example Successful Response

{
    "message": "Success",
    "data": [
        {
            "cin": "U72900GJ2019PTC111114",
            "category": "COMPANY",
            "company_name": "RELIABLE CONTROL SYSTEMS PRIVATE LIMITED"
        },
        {
            "cin": "U93090UP2019PTC116779",
            "category": "COMPANY",
            "company_name": "RELIANT MANPOWER SUPPLY PRIVATE LIMITED"
        },
        {
            "cin": "AAQ-7932",
            "category": "LLP",
            "company_name": "RELIA ADVISORY SERVICES LLP"
        },
        {
            "cin": "U72900TG2019PTC137848",
            "category": "COMPANY",
            "company_name": "RELIABULL.TECH PRIVATE LIMITED"
        },
        {
            "cin": "U60200GJ2019PLC108724",
            "category": "COMPANY",
            "company_name": "RELIANCE ETHANE PIPELINE LIMITED"
        },
        {
            "cin": "U63030DL2019PTC356772",
            "category": "COMPANY",
            "company_name": "RELIABLE RYDES PRIVATE LIMITED"
        },
        {
            "cin": "U22130MH2019PTC334908",
            "category": "COMPANY",
            "company_name": "RELIANCE FILMS DISTRIBUTION PRIVATE LIMITED"
        },
        {
            "cin": "U33309MH2019PTC332388",
            "category": "COMPANY",
            "company_name": "RELIABILITY HEALTHCARE PRIVATE LIMITED"
        },
        {
            "cin": "U36910RJ2020PTC068276",
            "category": "COMPANY",
            "company_name": "RELIABLE GOLD INDIA PRIVATE LIMITED"
        },
        {
            "cin": "U22300MH2020PTC335509",
            "category": "COMPANY",
            "company_name": "RELIANCE FILMS PRIVATE LIMITED"
        }
    ],
    "message_code": "success",
    "status_code": 200,
    "success": true
}

Possible Error Responses

Authentication Error

Validation Error

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

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 type-ahead search with a minimum of 3 characters for optimal results

Display company category (COMPANY/LLP) alongside search results for clarity

Consider caching frequent searches to improve response times

Provide clear feedback when no matching companies are found

Code Samples

cURL

Python

Node.js

Related APIs

Company Verification API - Verify company details using CIN

Director Information API - Retrieve director information for a company

Company Financial API - Get financial data for registered companies

Compliance and Legal Considerations

The company information provided through this API is sourced from official government registries. When using this data for KYC or compliance purposes, ensure you follow all applicable regulations regarding business verification and data usage. The data should be used in accordance with relevant data protection laws and privacy regulations.

{ "message": "Success", "data": [ { "cin": "U72900GJ2019PTC111114", "category": "COMPANY", "company_name": "RELIABLE CONTROL SYSTEMS PRIVATE LIMITED" }, { "cin": "U93090UP2019PTC116779", "category": "COMPANY", "company_name": "RELIANT MANPOWER SUPPLY PRIVATE LIMITED" }, { "cin": "AAQ-7932", "category": "LLP", "company_name": "RELIA ADVISORY SERVICES LLP" }, { "cin": "U72900TG2019PTC137848", "category": "COMPANY", "company_name": "RELIABULL.TECH PRIVATE LIMITED" }, { "cin": "U60200GJ2019PLC108724", "category": "COMPANY", "company_name": "RELIANCE ETHANE PIPELINE LIMITED" }, { "cin": "U63030DL2019PTC356772", "category": "COMPANY", "company_name": "RELIABLE RYDES PRIVATE LIMITED" }, { "cin": "U22130MH2019PTC334908", "category": "COMPANY", "company_name": "RELIANCE FILMS DISTRIBUTION PRIVATE LIMITED" }, { "cin": "U33309MH2019PTC332388", "category": "COMPANY", "company_name": "RELIABILITY HEALTHCARE PRIVATE LIMITED" }, { "cin": "U36910RJ2020PTC068276", "category": "COMPANY", "company_name": "RELIABLE GOLD INDIA PRIVATE LIMITED" }, { "cin": "U22300MH2020PTC335509", "category": "COMPANY", "company_name": "RELIANCE FILMS PRIVATE LIMITED" } ], "message_code": "success", "status_code": 200, "success": true }

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

AutoComplete

Company AutoComplete#

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

Company AutoComplete

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples