POSTCIN Verification

Verify Company Identification Numbers (CIN) against MCA records — returns company name, incorporation details, directors, and CIN status.

POST/tools/kyc/cin

The CIN Verification API lets you validate a Company Identification Number (CIN) against Ministry of Corporate Affairs records in real time. It returns the registered company name, registration number, incorporation date, CIN status (active / struck-off / dormant / under liquidation), company email, country of incorporation, and a full list of directors with their DIN, designation, address, and date of birth. Use it for KYB onboarding, vendor due diligence, lending workflows, and corporate compliance checks.

Body parameters

Field	Type	Required	Description
`initiator_id`	string	required	Registered mobile number of the API user (see Platform Credentials).e.g. 9962981729
`user_code`	string	required	User code of the retailer/agent the service is run for.e.g. 20810200
`client_ref_id`	string	optional	Unique reference id per API call, generated by your system.e.g. REQ-20260101-001
`cin`	string	required	Alphanumeric Company Identification Number (CIN) assigned by the Ministry of Corporate Affairs, India.e.g. U72900KA2015PTC082988

initiator_idstringRequired

Registered mobile number of the API user (see Platform Credentials).

example: 9962981729

user_codestringRequired

User code of the retailer/agent the service is run for.

example: 20810200

client_ref_idstringoptional

Unique reference id per API call, generated by your system.

example: REQ-20260101-001

cinstringRequired

Alphanumeric Company Identification Number (CIN) assigned by the Ministry of Corporate Affairs, India.

example: U72900KA2015PTC082988

Headers

Field	Type	Required	Description
`developer_key`	string	required	Static API key issued to your account after KYC.
`secret-key`	string	required	Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).
`secret-key-timestamp`	string	required	Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.
`content-type`	string	required	application/jsone.g. application/json

developer_keystringRequired

Static API key issued to your account after KYC.

secret-keystringRequired

Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))).

secret-key-timestampstringRequired

Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time.

content-typestringRequired

application/json

example: application/json

Responses

statusnumber
Primary success indicator (0 = success).
messagestring
Human-readable response / error message.
response_status_idnumber
Granular status id; see the shared error-codes table.
response_type_idnumber
A unique id for every possible response shape (success or error) — useful for client logic branching and analytics.
dataobject
API-specific response payload.
- cinstring
  The CIN submitted in the request, echoed back for confirmation.
- company_namestring
  MCA-registered legal name of the company.
- registration_numbernumber
  Numeric company registration number assigned by the Registrar of Companies.
- incorporation_datestring
  Date the company was incorporated, in YYYY-MM-DD format.
- cin_statusstring
  Current status of the CIN as recorded by MCA — e.g. Active, Strike-Off, Dormant, Under Liquidation.
- emailstring
  Company email address from MCA records.
- incorporation_countrystring
  Country in which the company was incorporated.
- director_detailsarray
  List of directors of the company as registered with MCA.
  - namestring
    Full legal name of the director.
  - dinstring
    Director Identification Number (DIN) allotted by MCA.
  - designationstring
    Role/designation of the director at the company.
  - dobstring
    Date of birth of the director, in YYYY-MM-DD format.
  - addressstring
    Registered address of the director as filed with MCA.