datastandard

Identity, listing status, market cap and industry classification for one company.

get_company_profile

Filed financial figures for one company, one row per line item with its value, period, basis and filing. Consolidated by default. The element filter ("revenue", "profit after tax", "EPS") narrows an otherwise large answer. Lines with similar names are different figures.

get_xbrl_facts

Details of one filing: its type, the period it covers, and its file.

get_document_meta

The page images and text of one filing, by document_id and page numbers, for any document search_pages returns. A figure on a filing page is read from the image.

get_pages

Segment revenue, result and assets as the company reported them, on one basis and one period length per answer. Rows flagged reconciliation or residual are not part of a segment total.

get_segments

Who owns the company, from its SEBI Regulation 31 filings: promoter and public holding, institutions, named large holders, promoter pledge. Snapshots are as at the date on the row. Percentages are already percentages. The category rows form a tree; the parent is the total.

get_shareholding

What datastandard is, what it is not, what its data carries, and the guided recipes. Counts towards the per-minute limit, never the plan's call allowance.

guide

The covered companies, optionally filtered by sector or minimum market cap (in crore). Paged; pagination.truncated says whether more follow.

list_companies

The filings available for a company: annual reports, results, shareholding filings, earnings calls, investor presentations, announcements, corporate-action filings and offer documents. Paged. Returns the document_id the other tools take.

list_documents

The exact names screen_companies accepts: line items as get_xbrl_facts prints them, shareholding categories and measures, the exchange's own filing categories with their event_ref and the day each was last filed, sectors and industries, segment measures, and filed declarations with every value filed.

list_screen_fields

One saved artefact with a short-lived signed link to the file, readable by fetching the link.

get_artefact

Whether datastandard is reachable and the connection is valid, proven by a live query for company data. Counts towards the per-minute limit, never the plan's call allowance.

ping

Consecutive pages of one earnings-call transcript by page number, as images. Does not search: search_call_text finds the page and this reads the exchange around it. One company, one fiscal year, one quarter per call.

get_call_pages

Specific pages of one offer document by page number, as images. Does not search; the document_id comes from search_offer_document_text or list_documents.

get_offer_document_pages

Consecutive slides of one investor presentation by page number, as images. Does not search. With no quarter given, the deck that reports the full year is read.

get_presentation_pages

The company's own filing behind one announcement, as page images, in page order — the letter, the press release, the results, the deck or the transcript the exchange listed that day. The announcement_id comes from list_announcements.

get_announcement_pages

The company's own filing behind one corporate action, as page images: the board outcome, the public announcement, the record-date notice. The action_id comes from get_corporate_actions.

get_action_pages

Saves a produced file (report, model, memo, deck) into the firm's store. Saving is two calls with an upload in between: this returns an upload link for an HTTP PUT of the file, and confirm_artefact completes it. Nothing is saved until confirmed. The file is stored, never read.

save_artefact

The covered companies whose filed figures, filed declarations, shareholding, segments and exchange filings meet a set of conditions, with the filed values that decided each result and the filing behind every value. Up to 50 companies a page; companies without a filed value to test are listed apart.

screen_companies

Where something appears across a company's announcement filings, as pages, best match first. Each page names the announcement it belongs to and the date it was filed.

search_announcement_text

Where something appears on a company's investor presentation slides for one fiscal year, as slides. The extracted slide text has no layout, so a figure is read off the slide image (images true, or get_presentation_pages). Each page says which kind of deck it came from.

search_presentation_text

Where something appears in a company's offer documents, as pages. Each page says which of the three it came from: the draft carries no price, the red herring usually prints a placeholder for the band, the prospectus carries the struck price.

search_offer_document_text

The companies matching a name, NSE symbol, ISIN or BSE code. When several match, the candidates are returned and none is picked.

search_companies

Filing pages that discuss a subject across up to 50 companies and a range of fiscal years, from annual reports, earnings calls, investor presentations, exchange announcements, offer documents and corporate-action filings. Each hit carries the page text and where it is printed.

search_pages

Where something is discussed in one annual report for one fiscal year, as pages. A page matches when it carries most of the query words; a quoted phrase must appear exactly. Each page says which basis it belongs to.

search_filing_text

Where a subject was discussed on a company's earnings calls, as transcript pages: one fiscal year (quarter optional), a range of dates, or the latest few calls. The speaker's name is printed on the page beside their words; datastandard does not label speakers. A page matches when it carries most of the query words.

search_call_text

Gives colleagues access to a saved artefact: the whole firm, or named people by login email. They can read and download it, not change or delete it.

share_artefact

Every field of the tagged form filed with an announcement — the date, venue and attendees of an analyst meeting, the dividend rate a board recommended — as the company tagged them, in filing order. Only rows whose form is xbrl carry one; the announcement_id comes from list_announcements.

get_announcement_facts

Withdraws access to a saved artefact that was shared: from the whole firm, or from named colleagues by login email. The artefact itself is not changed or deleted.

unshare_artefact