---
title: "COI Advance Verification"
method: POST
path: "/verify/coi_advance"
tags: ["Know Your Business"]
---

# COI Advance Verification

`POST /verify/coi_advance`

Fetches advanced Company Identification details using CIN or Company ID. Either cin or company_id is mandatory. CIN is preferred if both are provided.

## Request body

- union
  - object
    - `cin` string, required
    - `company_id` string
    - `user_id` string
  - object
    - `cin` string
    - `company_id` string, required
    - `user_id` string

## Response `200`

Verification completed successfully (valid or invalid CIN)

- COIAdvanceResponse
  - `status` string
  - `result` union
    - COIAdvanceSuccessResult
      - `data` COIAdvanceData
        - `company_master_data` COICompanyMasterData
          - `cin` string
          - `company_id` string
          - `company_llp_name` string
          - `roc_code` string
          - `registration_number` string
          - `company_category` string
          - `company_subcategory` string
          - `class_of_company` string
          - `authorised_capital` number
          - `paid_up_capital` number
          - `date_of_incorporation` string
          - `registered_address` string
          - `email_id` string
          - `company_registered_state` string
          - `company_registered_city` string
          - `company_registered_pin_code` string
          - `company_status` string
        - `charges` object[]
        - `directors_signatory_details` object
        - `potential_related_party_details` object
        - `all_directorship_details` object[]
      - `status` integer
    - COIAdvanceInvalidResult
      - `cin` string
      - `company_id` string
      - `status` string
  - `chargeble` string
  - `user_consent` string

## Other responses

- `400` — Bad request — missing or invalid parameters.
- `401` — Unauthorized — invalid client credentials.
- `403` — Forbidden — access denied or IP not whitelisted.
- `500` — Internal server error.
- `502` — Bad gateway — external verification service error.
- `504` — Gateway timeout — external verification service timeout.

---

[API](https://skmtc.dev/idto/apis/verification-api.md) · [All operations](https://skmtc.dev/idto/apis/verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idto/verification-api/revisions/e3d57dab8db4/schema)