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

Ways to call it

  • CINs: set queries (optional: include, maxResults)
  • Company Names: set names (optional: include, 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; a CIN that is not in the register returns no row and is not charged. 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.
string[]
Which optional blocks to fetch. Defaults to [“directors”,“financials”]; drop one to skip that lookup.
integer
Stop after this many have been looked up. Each one costs a row, so this caps the bill as well as the output. 0 or omitted means every identifier you sent.
string[]
One or more company names, or parts of one. Matching is case-insensitive and tries an exact prefix first, then a substring, so “reliance industries” finds RELIANCE INDUSTRIES LIMITED. ONE NAME CAN MATCH SEVERAL COMPANIES and each match 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 multi-year profit and loss, balance sheet and cash flow use mca/company-financials; for directors use mca/director.