Company Verification v2

Verify CIN / MCA details v2

Looks up an Indian company by its Corporate Identification Number (CIN) against MCA records using the v2 verification wrapper. Returns company identity, status, and a brief of directors on a match.

Response contract: Every completed verification returns HTTP 200. A successful result returns status: "success" with error_code: null and a populated data object. A valid request with no matching record (or a business rejection) also returns HTTP 200 with status: "failed", a non-null error_code, and data: null. Do not treat HTTP 200 alone as success — always branch on status and inspect error_code. Authenticate with your X-Client-ID and X-API-KEY headers. Transport, auth, and validation problems use standard 4xx/5xx status codes.

post/v2/verify/cin_mca_verification

Request

  • Base URL
    https://prod.idto.ai
  • URL
    https://prod.idto.ai/v2/verify/cin_mca_verification
  • Auth
    API key in header X-API-KEY and API key in header X-Client-ID

Request body

id_numberstring required

CIN to lookup (Corporate Identification Number). Example: U99999DL2025PTC000001

Response

Company details returned for the supplied CIN

client_idstring
company_idstring required
company_typestring
company_namestring required
statusstring required
chargeblestring
user_consentstring

Changes

No recorded changes to this operation across all 1 revision of this API.