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

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.

Confirms the CIN you selected from the CIN Search results. Pass the company_name and the chosen selected_cin.
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"

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.