CKYC Legal Entity Search

Endpoint Overview

POST /api/v1/ckyc/v3/search/legal

Description

Search the CKYC registry for a legal entity record using an entity identifier type and identifier value. The response returns a wrapper client_id, a records array, and record_count.

The CKYC Legal Entity Search API allows authorized entities to query the Central KYC (CKYC) registry maintained by CERSAI (Central Registry of Securitisation Asset Reconstruction and Security Interest of India) to locate KYC records belonging to legal entities — such as Private Limited Companies, LLPs, Partnership Firms, Trusts, Societies, and other non-individual entities.

By providing an entity identifier type (such as PAN, CKYC number, certificate of incorporation, registration certificate, CKYC reference ID, or mobile number) along with the corresponding identifier value, the API searches the centralized repository and returns all matching records.

This is typically the first step in the legal entity CKYC download workflow. Once a matching record is found, you can use the returned ckyc_identifier to proceed with the CKYC Legal Entity Download endpoint to retrieve the full CKYC record.

Key Benefits

Single-step search for legal entities: Quickly locate CKYC records for companies, firms, and other non-individual entities using a variety of supported identifier types.

Multi-identifier support: Search by PAN, CKYC number, certificate of incorporation, registration certificate, CKYC reference ID, or mobile number — with automatic input normalization for consistent matching.

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Obtain your JWT token from the Surepass dashboard and include it in the Authorization header of every request.

Environment	Base URL
Sandbox	`https://sandbox.surepass.app`
Production	`https://kyc-api.surepass.app`

Request Parameters

Request Headers

Header	Required	Description
`Authorization`	Yes	Bearer token for authentication. Format: `Bearer <your_jwt_token>`
`Content-Type`	Yes	Must be set to `application/json`

Request Body

Parameter	Type	Required	Description
`id_type`	String	Yes	Legal entity identifier type. The wrapper normalizes case, spaces, and hyphens to lowercase snake_case. See the supported values table below.
`id_number`	String	Yes	Identifier value to search in the CKYC registry.

Supported `id_type` Values

Value	Notes
`pan`	Entity PAN
`ckyc_number`	14-digit CKYC number
`certificate_of_incorporation`	Certificate of incorporation number/value
`registration_certificate`	Registration certificate number/value
`ckyc_reference_id`	CKYC reference ID, typically starting with `LE`
`mobile_number`	Registered mobile number

Input Normalization

The API wrapper automatically normalizes the id_type value — converting case, spaces, and hyphens to lowercase snake_case. For example, Certificate of Incorporation, certificate-of-incorporation, and certificate_of_incorporation are all treated identically.

Example Request

{
  "id_type": "pan",
  "id_number": "ABCAA1234A"
}

Process Response

Response Parameters

Parameter	Type	Description
`data.client_id`	String	Surepass wrapper client identifier for tracking and reference purposes.
`data.records`	Array	Array of matching CKYC search records. Each object contains details of a matched legal entity.
`data.record_count`	Integer	Number of matched records returned in the `records` array.
`status_code`	Integer	HTTP status code of the response.
`success`	Boolean	Indicates whether the operation completed successfully.
`message`	String	Human-readable response message.
`message_code`	String	Machine-readable message identifier for programmatic handling.

Common Record Fields

Search record contents can vary depending on the matched CKYC record. Common fields include:

Field	Description
`ckyc_identifier`	Canonical CKYC identifier to use for download calls
`ckyc_no`	CKYC number, when available
`ckyc_reference_id`	CKYC reference ID, typically starting with `LE`
`fullname`	Legal entity's full registered name
`constitution_type`	Type of constitution (e.g., Private Limited Company, LLP, Trust)
`place_of_incorporation`	Place where the entity was incorporated/registered

Example Successful Response

{
  "data": {
    "client_id": "ckyc_realtime_JaopYqLdVbTf",
    "records": [
      {
        "ckyc_identifier": "22345678901234",
        "ckyc_no": "22345678901234",
        "ckyc_reference_id": "LEFILB20063639",
        "fullname": "ACME TECHNOLOGIES PRIVATE LIMITED",
        "constitution_type": "Private Limited Company",
        "place_of_incorporation": "MUMBAI"
      }
    ],
    "record_count": 1
  },
  "status_code": 200,
  "success": true,
  "message": "Success",
  "message_code": "success"
}

Code Samples

cURL

Python

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/ckyc/v3/search/legal' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "id_type": "pan", "id_number": "ABCAA1234A" }'

{ "data": { "client_id": "ckyc_realtime_JaopYqLdVbTf", "records": [ { "ckyc_identifier": "22345678901234", "ckyc_no": "22345678901234", "ckyc_reference_id": "LEFILB20063639", "fullname": "ACME TECHNOLOGIES PRIVATE LIMITED", "constitution_type": "Private Limited Company", "place_of_incorporation": "MUMBAI" } ], "record_count": 1 }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Description#

Technical Implementation#

Request Headers#

Request Body#

Supported id_type Values#

Example Request#

Response Parameters#

Common Record Fields#

Example Successful Response#

Code Samples#

Request

Responses