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 underparams. Only the keys below are accepted; any other key returns 422 invalid_params.
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.Which optional blocks to fetch. Defaults to [“directors”,“financials”]; drop one to skip that lookup.
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.
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 indata is one companie, keyed by these fields.
Example response
Abridged: long text and lists are shortened.Related APIs
For the multi-year profit and loss, balance sheet and cash flow usemca/company-financials; for directors use mca/director.