Verification API

CIN Verification API

Verify a CIN is valid and return the company's status and legal name.

GET /v1/verify/cin/{cin}
1 credits per successful call · full rate card

Overview

The CIN Verification API confirms whether a Corporate Identity Number is valid - checking both its format and its existence in MCA data - and returns the company's current status and legal name. It is a fast yes/no check for onboarding, forms and data cleaning.

  • Format + existence check
  • Returns valid true/false
  • Company status and legal name
  • MCA-sourced
  • Single fast call

Auth, limits & freshness

  • Auth: Send Authorization: Bearer <api_key> (pk_test_… or pk_live_…).
  • Rate / credits: Fair-use and plan limits apply; see your API console for remaining credits.
  • Freshness: Sourced from Infyner’s MCA-aligned company master; refresh cadence varies by dataset.
  • Errors: Errors return a JSON envelope with success=false and an error code (e.g. NOT_FOUND, UNAUTHORIZED).

How it works

  1. Generate an API key in your developer console (test keys are free).
  2. Call the endpoint with your Bearer key.
  3. Read the JSON response (standard envelope with credits info).
  4. Map the fields into your product or workflow.

Request & response

Requestcurl "https://www.infyner.com/v1/verify/cin/L74999WB1991PLC051738" \ -H "Authorization: Bearer pk_test_xxxxxxxx"
Response (sample){ "success": true, "data": { "cin": "...", "valid": true, "format_valid": true, "status": "Active", "legal_name": "..." } }

Try it live with a free test key from your sandbox.

Where it's used

  • Validate a CIN at onboarding
  • Clean a CIN column in your data
  • Form / input validation
  • Pre-check before enrichment

Frequently asked questions

How is a CIN verified?

We check the 21-character CIN format and confirm the CIN exists in our MCA dataset, returning its current status and legal name.

Related APIs

Start building in minutes

Generate a free test key, call the sandbox, and go live when you're ready.

Get API access