Feel free to reach techsupport@surepass.io for any technical support or guidance.
AutoComplete
Production
https://kyc-api.surepass.app
Production
https://kyc-api.surepass.app
GET
https://kyc-api.surepass.app
Company AutoComplete
Description
Key Benefits
Use Cases
Financial Services
Compliance
Business Services
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 Different authentication tokens are used for sandbox and production environments: Sandbox: Production:
1.
2.
3.
Authorization header as Bearer TOKEN.https://sandbox.surepass.iohttps://kyc-api.surepass.ioRequest 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
}Integration Best Practices
Security Recommendations
User Experience Guidelines
Code Samples
cURL
Python
Node.js
Related APIs
Compliance and Legal Considerations
Request
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://kyc-api.surepass.app/api/v1/corporate/company-autofill?company={{company_name}}' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'Response Response Example
{
"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
}