Skip to main content
POST
/
api
/
v1
/
sub-accounts
/
{sub_auth_id}
/
kyc
/
cin
/
search
CIN search
curl --request POST \
  --url https://api.vobiz.ai/api/v1/sub-accounts/{sub_auth_id}/kyc/cin/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_name": "ACME PRIVATE LIMITED"
}
'
{
  "matches": [
    {
      "cin": "U72900KA2024PTC123456",
      "company_name": "ACME PRIVATE LIMITED",
      "status": "Active"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt

Use this file to discover all available pages before exploring further.

Performs a name-based CIN (Corporate Identity Number) lookup. Returns a list of candidate company matches; select one and pass it to CIN Confirm.
Authenticate as the parent main account with Authorization: Bearer {parent_jwt}.

Authorizations

​
Authorization
string
header
required

Parent main-account JWT. Sub-account KYC endpoints authenticate as the parent account that owns the sub-account (or an admin), not with the X-Auth-ID / X-Auth-Token header pair.

Path Parameters

​
sub_auth_id
string
required

The sub-account's Auth ID.

Example:

"SA_XXXXXX"

Body

application/json
​
company_name
string
required
Example:

"ACME PRIVATE LIMITED"

Response

200 - application/json

Candidate matches