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 CodeStatusMessageNext Action
200SUCCESSINVALIDEnter the correct information in the request.
400ERRORverification_id is missing in the request.Enter a valid verification_id in the request.
400ERRORverification_id can include only alphanum, dot, hyphen, and underscores.Only alphanumeric, period (.), hyphen (-), and underscore ( _ ) are allowed.
400ERRORcin is missing in the request.Enter the unique alphanumeric identifier (CIN) assigned to companies in the request.
400ERRORcin should be of 21 character alphanumeric string of format (X00000XX0000XXX000000).Enter the correct format of the CIN information in the request.
400ERRORClient secret belongs to test environmentEnter the correct environment credentials in the request.
400ERRORx-client-id is missing in the request.Enter all the header information in the API request.
401ERRORInvalid clientId and clientSecret combinationEnsure you enter valid x-client-id and x-client-secret information in the API request.
403ERRORIP not whitelisted your current ip is IP whitelisting assistance, visit our guide at the IP address.
409ERRORverification id already existsEnter a unique verification ID to identify the request.
422ERRORInsufficient balance to process this requestTry again with sufficient balance.
500ERRORsomething went wrongTry again after some time.
502ERRORverification attempt failedTry again after some time.
Click Try It! to start a request and see the response here!