Feel free to reach techsupport@surepass.io for any technical support or guidance.
Bulk Upload
Production
https://kyc-api.surepass.app
Production
https://kyc-api.surepass.app
POST
https://kyc-api.surepass.app
Bulk Upload
Description
Key Benefits
Use Cases
Financial Services
HR & Recruitment
Government & Enterprise
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 for authentication (JWT) |
| Content-Type | Yes | multipart/form-data |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
| file | File (CSV/ZIP) | Yes | The CSV or ZIP file containing the data to be verified |
| type_of_job | String | Yes | Specifies the type of verification to be performed |
Supported type_of_job Values
| Value | Description |
|---|---|
| pan_aadhaar_check | Verify PAN and Aadhaar linkage |
| pan_aadhaar_linker | Link PAN and Aadhaar |
| aadhaar_validation | Validate Aadhaar details |
| pan | Verify PAN details |
| gstin | Verify GSTIN details |
| rc | Verify vehicle registration certificate |
| bank_verification | Verify bank account details |
| chassis_engine_to_rc | Match chassis/engine number to RC |
| pan_comprehensive | Comprehensive PAN verification |
| custom | Custom verification type |
Process Response
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| data | Object | Contains the response data |
| data.client_id | String | Unique identifier for the bulk job |
| data.type_of_job | String | The type of verification job submitted |
| data.job_status | String | Current status of the bulk job |
| status_code | Integer | HTTP status code |
| message_code | String | Status message code |
| message | String | Additional message (if any) |
| success | Boolean | Indicates if the request was successful |
Possible job_status Values
| Value | Description |
|---|---|
| pending | The job is queued and waiting to be processed |
| completed | The job has been successfully processed |
| failed | The job processing has failed |
Example Successful Response
{
"data": {
"client_id": "bulk_solver_eOsupsDawFjnewtnnzui",
"type_of_job": "gstin",
"job_status": "pending"
},
"status_code": 200,
"message_code": "success",
"message": null,
"success": true
}Possible Error Responses
Invalid File Format
Invalid Job Type
Authentication Error
{
"data": null,
"status_code": 400,
"message_code": "error",
"message": "Invalid file format. Please upload a CSV or ZIP file.",
"success": false
}Integration Best Practices
Security Recommendations
User Experience Guidelines
Code Samples
cURL
Python
Node.js
Related APIs
Compliance and Legal Considerations
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://kyc-api.surepass.app/api/v1/bulk-solver/' \
--form 'file=@""' \
--form 'type_of_job="gstin"'Response Response Example
{
"data": {
"client_id": "bulk_solver_eOsupsDawFjnewtnnzui",
"type_of_job": "gstin",
"job_status": "pending"
},
"status_code": 200,
"message_code": "success",
"message": null,
"success": true
}Request
Body Params multipart/form-data