CIN Upload

Endpoint Overview

POST /api/v1/ocr/cin

Description

This API endpoint enables the extraction of information from Certificate of Incorporation (CIN) documents through Optical Character Recognition (OCR) technology. It allows businesses to upload CIN documents and receive structured data extracted from the document, facilitating automated verification and data entry processes for corporate entity validation.

Key Benefits

Automated extraction of key information from CIN documents

Reduction in manual data entry errors and processing time

Streamlined corporate client onboarding and KYC processes

Enhanced compliance with regulatory requirements for business verification

Use Cases

Financial Services

Legal Services

Business Services

Streamlining corporate account opening processes by automating CIN verification

Enhancing KYB (Know Your Business) compliance checks for corporate clients

Validating business entities before approving corporate credit facilities

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	JWT Bearer token for authentication. Format: `Bearer <token>`
Content-Type	Yes	Must be set to `multipart/form-data`

Request Body

Parameter	Type	Required	Description
file	File	Yes	The CIN document image file to be processed. Supported formats: JPG, JPEG, PNG, PDF
link	String	No	Alternative to file upload. URL of the CIN document image

Example Request

# Using multipart/form-data

# Form fields:
file: [binary data of the CIN document]

# OR alternatively:
link: "https://example.com/path/to/cin_document.jpg"

Process Response

Response Parameters

Parameter	Type	Description
success	Boolean	Indicates if the API request was successful
data	Object	Contains the extracted information from the CIN document
data.cin	String	Certificate of Incorporation Number
data.company_name	String	Name of the company as registered
data.incorporation_date	String	Date of incorporation of the company
data.company_type	String	Type of company (e.g., Private Limited, Public Limited)
data.registered_address	String	Registered address of the company
data.authorized_capital	String	Authorized capital of the company
data.paid_up_capital	String	Paid-up capital of the company
data.business_activity	String	Main business activity of the company
data.directors	Array	List of company directors
message	String	Status message from the API
status_code	Integer	HTTP status code

Example Successful Response

{
  "success": true,
  "data": {
    "cin": "U72900KA2015PTC123456",
    "company_name": "EXAMPLE TECHNOLOGIES PRIVATE LIMITED",
    "incorporation_date": "15/06/2015",
    "company_type": "Private Limited Company",
    "registered_address": "123, EXAMPLE TECH PARK, WHITEFIELD, BANGALORE, KARNATAKA, 560066",
    "authorized_capital": "Rs. 10,00,000",
    "paid_up_capital": "Rs. 1,00,000",
    "business_activity": "Computer programming, consultancy and related activities",
    "directors": [
      "JOHN DOE",
      "JANE SMITH"
    ]
  },
  "message": "CIN data extracted successfully",
  "status_code": 200
}

Possible Error Responses

Authentication Error

Invalid Image

Server Error

{
    "error": null,
    "message": "Your token is invalid. Please ensure that correct token is being used.",
    "status_code": 401,
    "success": false,
    "message_code": "invalid_token"
}

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 proper error handling to avoid exposing sensitive information

Use HTTPS for all API communications to ensure data encryption in transit

Implement token refresh mechanisms to handle token expiration gracefully

User Experience Guidelines

Provide clear feedback to users during document upload and processing

Implement a timeout handling mechanism for large documents that may take longer to process

Allow users to review extracted information and make corrections if needed

Include document quality guidelines to ensure optimal OCR results

Code Samples

cURL

Python

Node.js

Related APIs

PAN Card OCR: Extract information from PAN cards using OCR technology

Aadhaar Card OCR: Extract information from Aadhaar cards using OCR technology

GST Certificate OCR: Extract information from GST certificates using OCR technology

Business Verification API: Verify business entities using government databases

Compliance and Legal Considerations

When processing CIN documents, ensure compliance with data protection regulations. The extracted information may contain sensitive business data that should be handled securely. Implement appropriate data retention policies and ensure user consent is obtained where required by applicable laws.

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

{ "success": true, "data": { "cin": "U72900KA2015PTC123456", "company_name": "EXAMPLE TECHNOLOGIES PRIVATE LIMITED", "incorporation_date": "15/06/2015", "company_type": "Private Limited Company", "registered_address": "123, EXAMPLE TECH PARK, WHITEFIELD, BANGALORE, KARNATAKA, 560066", "authorized_capital": "Rs. 10,00,000", "paid_up_capital": "Rs. 1,00,000", "business_activity": "Computer programming, consultancy and related activities", "directors": [ "JOHN DOE", "JANE SMITH" ] }, "message": "CIN data extracted successfully", "status_code": 200 }

CIN Upload

CIN Upload#

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

CIN Upload

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples