Finbar

Get metadata for the active published company dataset. Use get_dataset_catalogue to discover queryable historical series.

get_dataset

Discover historical metrics and exact scope paths grouped by reporting basis, with a shared top-level periods array covering the entire dataset, identical on every page. Individual series may have gaps; missing observations return null. Follow next_cursor to read all series. Pass expected_dataset_id to detect a changed publication.

get_dataset_catalogue

Retrieve one Finbar entity by entity_id.

get_entity

Retrieve price history and market metadata for a Finbar entity.

get_market_data

List documents for a Finbar entity with optional type, inclusive period, and tag filters. Results use opaque cursor pagination ordered by report_date descending. The tag field is included when non-empty. A non-empty tag is human-readable, free-form metadata that distinguishes documents with the same type and period. It usually identifies a file format, an indexed part split from a master document, or a subsidiary. In a subsidiary document set, an empty tag normally represents the parent consolidated group statements.

list_documents

Query historical company dataset series using metric IDs and exact ordered scope combinations from get_dataset_catalogue. Period mode is exact (coordinates), fiscal_range (from/to fiscal ends with zero duration), or trailing (months), bounded to 120. Defaults to original values; latest_restated selects the final populated restatement with original fallback. Returns aligned values and source references. Values retain stored scale; no aggregation. Fetching sources requires documents:read.

query_dataset

Read a paragraph/table item or a bounded document window. Document windows require limit and exactly one of start_index or an opaque cursor, and return next_cursor only when another renderable chunk exists.

read_document

Search paragraph and table content within exactly one document or an entity's documents, optionally filtered by inclusive period bounds. Results use opaque cursor pagination ordered by text score with deterministic paragraph/table tie-breaking.

search_document

Search for Finbar entities by name, ticker, or related query. Results include real relevance scores and use opaque cursor pagination ordered by score descending and entity ID ascending.

search_entity