CIN

Verify CIN

Use this API to retrieve information from CIN such as business incorporation date, director(s) details, CIN status, and more. View the test data and use the information to trigger the validations. The test data are usable only in the test environments such as gamma and sandbox.

Response Codes

Sub Code	Status	Message	Next Action
200	SUCCESS	VALID	-
200	SUCCESS	INVALID	Enter the correct information in the request.
400	ERROR	verification_id is missing in the request.	Enter a valid verification_id in the request.
400	ERROR	verification_id can include only alphanum, dot, hyphen, and underscores.	Only alphanumeric, period (.), hyphen (-), and underscore ( _ ) are allowed.
400	ERROR	cin is missing in the request.	Enter the unique alphanumeric identifier (CIN) assigned to companies in the request.
400	ERROR	cin should be of 21 character alphanumeric string of format (X00000XX0000XXX000000).	Enter the correct format of the CIN information in the request.
400	ERROR	Client secret belongs to test environment	Enter the correct environment credentials in the request.
400	ERROR	x-client-id is missing in the request.	Enter all the header information in the API request.
401	ERROR	Invalid clientId and clientSecret combination	Ensure you enter valid x-client-id and x-client-secret information in the API request.
403	ERROR	IP not whitelisted your current ip is 106.51.91.104.For IP whitelisting assistance, visit our guide at https://docs.cashfree.com/docs/ip-whitelisting-verification	Whitelist the IP address.
409	ERROR	verification id already exists	Enter a unique verification ID to identify the request.
422	ERROR	Insufficient balance to process this request	Try again with sufficient balance.
500	ERROR	something went wrong	Try again after some time.
502	ERROR	verification attempt failed	Try again after some time.

POST

cin

{
  "verification_id": "ABC00123",
  "reference_id": 12345,
  "status": "VALID",
  "cin": "U72900KA2015PTC082988",
  "company_name": "COMPANY NAME",
  "registration_number": 82987,
  "incorporation_date": "2015-09-23",
  "cin_status": "ACTIVE",
  "email": "abc@xyz.com",
  "incorporation_country": "INDIA",
  "director_details": [
    {
      "din": "07168822",
      "name": "Frank Kelvin",
      "dob": "1997-07-21",
      "designation": "DIRECTOR",
      "address": "ST BED KORAMANGALA, BANGALORE, KARNATAKA, INDIA, 566634"
    },
    {
      "din": "07168826",
      "name": "John Doe",
      "dob": "1997-02-07",
      "designation": "DIRECTOR",
      "address": " GAUTAM NAGAR, NOIDA, UTTAR PRADESH, INDIA, 211361"
    }
  ]
}

Authorizations

x-client-id

string

headerrequired

Client ID. You can find your ID in the Merchant Dashboard.

x-client-secret

string

headerrequired

Client secret key. You can find your secret key in the Merchant Dashboard.

Headers

x-cf-signature

string

Send the signature if IP is not whitelisted

Body

application/json

Find the request parameters to retrieve CIN information

verification_id

string

default: ABC00123required

It is the unique ID you create to identify the API request. The maximum character limit is 50. Alphanumeric, period (.), hyphen (-). and underscore ( _ ) are allowed.

cin

string

default: U72900KA2015PTC082988required

It is the unique alphanumeric identifier assigned to companies registered under the Ministry of Corporate Affairs, India.

Response

200 - application/json

Success response for retrieving CIN information

verification_id

string

It displays the unique ID you created to identify the API request.

reference_id

integer

It displays the unique ID created by Cashfree Payments for reference purposes.

status

string

It displays the status of the CIN information

cin

string

It displays the entered CIN information.

company_name

string

It displays the name of the company registered under the Ministry of Corporate Affaris.

registration_number

number

It displays the registration number of the company.

incorporation_date

string

It displays the date of incorporation of the company.

cin_status

string

It displays the granular level status of the CIN information.

string

It displays the email ID of the company registered under the Ministry of Company Affairs.

incorporation_country

string

It displays the name of the country where the company is located.

director_details

object[]

Was this page helpful?

Bank Account Verification Sync V2 Get DigiLocker Verification Status

{
  "verification_id": "ABC00123",
  "reference_id": 12345,
  "status": "VALID",
  "cin": "U72900KA2015PTC082988",
  "company_name": "COMPANY NAME",
  "registration_number": 82987,
  "incorporation_date": "2015-09-23",
  "cin_status": "ACTIVE",
  "email": "abc@xyz.com",
  "incorporation_country": "INDIA",
  "director_details": [
    {
      "din": "07168822",
      "name": "Frank Kelvin",
      "dob": "1997-07-21",
      "designation": "DIRECTOR",
      "address": "ST BED KORAMANGALA, BANGALORE, KARNATAKA, INDIA, 566634"
    },
    {
      "din": "07168826",
      "name": "John Doe",
      "dob": "1997-02-07",
      "designation": "DIRECTOR",
      "address": " GAUTAM NAGAR, NOIDA, UTTAR PRADESH, INDIA, 211361"
    }
  ]
}

Secure ID APIs

V2

V1

Verify CIN

Response Codes

Authorizations

Headers

Body

Response