Skip to main content
POST
CIN confirm
Confirms the CIN you selected from the CIN Search results. Pass the company_name and the chosen selected_cin.
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
Pass the selected_cin verbatim from a search result - don’t hand-type it. Confirming a CIN that wasn’t returned by search will not verify. This step persists the cin verification and recomputes kyc_calls_blocked.

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"

selected_cin
string
required
Example:

"U72900KA2024PTC123456"

Response

200 - application/json

Verification result

Outcome of a single KYC verification step.

verification_type
enum<string>
required
Available options:
pan,
gst,
cin,
aadhaar
status
enum<string>
required
Available options:
verified,
failed,
pending
kyc_calls_blocked
boolean

Recomputed sub-account call-blocking state after this verification.

mock
boolean

Present and true on responses from the test-mode endpoints.