Skip to main content
POST
CIN search
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 with your parent main account’s X-Auth-ID and X-Auth-Token - the same credentials used everywhere else in the API.

Request body

Response example

200 OK
Search is name-based and may return multiple candidates (or none). Pick the exact match and pass both its cin (as selected_cin) and the company_name to CIN Confirm - confirm is what actually persists the verification.

Authorizations

X-Auth-ID
string
header
required

Your Vobiz account Auth ID

X-Auth-Token
string
header
required

Your Vobiz account Auth Token

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