Skip to main content
POST /v1/data/mca/company-financials/run Pricing: $1.00 per companie ($1,000.00 per 1,000). One or more 21-character CINs, or one or more company names.

Ways to call it

  • CINs: set queries (optional: maxResults)
  • Company Names: set names (optional: maxResults)

Request

Send the inputs under params. Only the keys below are accepted; any other key returns 422 invalid_params.
string[]
One or more 21-character Corporate Identity Numbers, e.g. L23201MH1952GOI008858. Each CIN returns one row. ONE BAD CIN DOES NOT SINK THE BATCH: anything that is not a valid CIN is skipped, the rest are looked up, and the run tells you which ones were skipped. Use names if you do not have the CIN.
integer
Stop after this many have been looked up. Each ROW costs, so this caps the bill as well as the output. With names it bounds the companies resolved, so you may get fewer rows than this if some have no financials on file. 0 or omitted means every identifier you sent, and for a NAME that means every company the name resolves to, up to 50. Set it when you send a name you have not narrowed.
string[]
One or more company names, or parts of one. Matching is case-insensitive and tries an exact prefix first, then a substring. ONE NAME CAN MATCH SEVERAL COMPANIES and each match with statements on file is a row, so use maxResults to bound a broad name.

Example

Response fields

Each row in data is one companie, keyed by these fields.

Example response

Abridged: long text and lists are shortened.
For the company master record (status, capital, address, directors) use mca/company, which costs far less.