verification

Turnover, current and previous financial year

Turnover for the latest two financial years on record, lifted from the company's own filed AOC-4 (audited revenue from operations) or MGT-7 (company-declared turnover). Cache-first: companies already on record answer at once. A company not yet on record is fetched from MCA on demand; the response is 202 with Retry-After and the same call is polled until it returns 200. A 200 with coverage 'unavailable' states why MCA holds no figure (first accounts not yet due, no accounts ever filed, form unreadable). Companies only (21-character CIN). A 202 is not charged.

post/kyc/company/financials

Request

Base URL: https://api.qorpiq.com
URL: https://api.qorpiq.com/kyc/company/financials
Auth: API key in header x-api-key

Request body

cinstring required

Example request

{
  "cin": "L85110KA1981PLC013115"
}

Response

Figures on record, or a definitive reason none exist.

transaction_idstring uuid

checkstring

cinstring

company_namestring nullable

status'ready'

coverage'complete' | 'partial' | 'unavailable'

complete = both years; partial = one year on record; unavailable = none, see reason.

reason'not_yet_filed' | 'no_annual_filings' | 'form_unreadable' | 'fetch_failed'

Present when coverage is unavailable.

incorporation_datestring date nullable

Present when coverage is unavailable.

currencystring

unitstring

notestring

timestampinteger

Example response

{
  "check": "company_financials",
  "current_year": {
    "fy_end": "2025-03-31",
    "fy_label": "FY 2024-25"
  },
  "previous_year": {
    "fy_end": "2025-03-31",
    "fy_label": "FY 2024-25"
  },
  "currency": "INR",
  "unit": "rupees"
}

Changes

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