Company details API reference

Company details

Returns company registration, status, capital and directors from a CIN.

Endpoint

POST https://api.finovel.in/v1/company-details

Charged only when the call succeeds. Errors are never charged. See how every API works for keys, retries and status codes.

Request fields

Field	Type	Required	Description
`id_number`	text	Yes	CIN

Example request

curl -X POST https://api.finovel.in/v1/company-details \
  -H "Authorization: Bearer fin_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{"id_number":"U72900KA2020PTC123456"}'

Response fields

Inside data:

Field	Description
`company_name`	Company
`company_status`	Status
`date_of_incorporation`	Incorporated on
`paid_up_capital`	Paid-up capital
`directors`	Directors

Example response from the sandbox

{
  "request_id": "req_...",
  "success": true,
  "status": "success",
  "environment": "sandbox",
  "message": "OK",
  "data": {
    "client_id": "company_details_sandbox",
    "directors": [
      {
        "din_number": "00000001",
        "director_name": "SANDBOX DIRECTOR"
      }
    ],
    "company_name": "SANDBOX TECHNOLOGIES PRIVATE LIMITED",
    "company_status": "Active",
    "paid_up_capital": "100000",
    "date_of_incorporation": "2020-03-15"
  },
  "error": null,
  "charged_paise": 0
}

Sandbox scenarios

With a test key, this API can return:

Not found (contains 000000)
Active company (default)