Retrieve Filing Details
filings_retrieveRead-onlyIdempotent
Retrieve detailed information for a single filing by its ID.
When to use this tool: Use to get full metadata for a single filing — source URL, PDF link, viewer URL, classification confidence, fiscal period. Call after filings_list when you need details beyond the list view. SHAREABLE LINKS: when a human needs to open the filing, hand them a PUBLIC link — viewer_url (the interactive web page) or document (the raw PDF/ZIP). NEVER give a user an /api/... URL — including the paginated next/previous links — those require credentials and 403 for an unauthenticated person. Filing CONTENT for you (the model) comes from filings_markdown_retrieve(filing_id), not from a URL.
When NOT to use this tool: Don't use for the actual filing content — use filings_markdown_retrieve. Don't use to search for filings — use filings_list.
Examples:
Show me the source PDF for this filing -> id= (Returns document (raw PDF/ZIP URL) and proxy_url (rendered))
Send me a link to read this filing -> id= (Share viewer_url (public web page) — never the /api/ markdown URL)
[Server current date: 2026-10-09 — treat this as today.]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| title | No | Optional title for the filing | |
| source | No | ||
| company | No | ||
| document | No | Direct link to our hosted copy of the original filing document or package (e.g. PDF/ZIP). Not signed and does not expire; anyone holding the link can download the file. Returns 404 if the filing is later removed or its document replaced. | |
| language | No | ||
| file_size | No | File size in bytes. Stores locally to avoid storage backend hits. | |
| proxy_url | No | Browser-renderable main document: for ZIP packages, a link that extracts and serves the main document; for every other format, the same link as the original document. | |
| source_url | No | Original public link for this filing at the source authority. Null when unavailable, for anonymised sources, or when the account does not have source identities unlocked. | |
| viewer_url | No | URL to view the filing in the interactive web platform. | |
| filing_date | No | The official date of the filing (soon to be deprecated). | |
| filing_type | No | ||
| fiscal_year | No | The accounting fiscal year this filing covers (e.g., 2024). Populated for annual, quarterly, interim reports and earnings releases. Null if not yet determined. | |
| updated_date | No | The date and time this filing record was last modified. | |
| fiscal_period | No | The specific fiscal period covered by this filing. Possible values: FY (Full Year), Q1, Q2, Q3, Q4, H1 (First Half), H2 (Second Half). Populated for annual, quarterly, interim reports and earnings releases. Null if not yet determined. * `FY` - Full Year * `Q1` - First Quarter * `Q2` - Second Quarter * `Q3` - Third Quarter * `Q4` - Fourth Quarter * `H1` - First Half * `H2` - Second Half * `9M` - Nine Months | |
| file_extension | No | File extension (e.g., PDF, HTML). | |
| ingestion_mode | No | Whether the filing was added to the platform promptly after publication. `REALTIME`: added within the source's normal publication delay (5 to 48 hours after `release_datetime`, depending on the source). `BACKFILLED`: everything else, including historical imports and new filings that reached the platform late, for example after a source outage. Set once when the filing is added and not recalculated afterwards. * `REALTIME` - Realtime * `BACKFILLED` - Backfilled | |
| release_datetime | No | Time the document was published on the authority page | |
| source_filing_id | No | The publisher's own identifier for this document, verbatim. Unique per source. On sources that publish one record per event and fan it out into one row per language and per attachment, the leading portion is a shared event stem, so rows of one disclosure sort together -- see the cross-language grouping recipe in the API docs. Null on legacy rows ingested before the identifier was retained. | |
| added_to_platform | No | Date and time when the filing was added to our platform | |
| processing_status | No | The lifecycle status of the raw document to markdown conversion. * `PENDING` - Pending * `QUEUED` - Queued * `PROCESSING` - Processing * `COMPLETED` - Completed * `FAILED` - Failed * `SKIPPED` - Skipped | |
| period_ending_date | No | The exact date the reported financial period ends (e.g., 2024-12-31). Populated for annual, quarterly, interim reports and earnings releases. Null if not yet determined. | |
| source_filing_type | No | The source authority's own classification label, verbatim. Null when the source publishes no label, it was not captured, or the source is anonymised. Not gated on source identities. | |
| language_confidence | No | Confidence score (0.0–1.0) from detecting the language against the document's own text. Null when detection reached no usable answer, which includes the case where it never ran — use language_verified_at to tell those apart. | |
| language_verified_at | No | When the language was checked against the document's own text. Null means it never was: the language is the value asserted when the filing was ingested, which is reliable for a source that files in one language and a guess for one that publishes the same disclosure in several. A non-null value with a null language_confidence means the document was read but no confident answer came out of it. | |
| filing_type_reasoning | No | Step-by-step rationale produced by the automated classification system for the assigned filing type. Indicative only — not manually reviewed. | |
| dissemination_datetime | No | Time the document was released to the public and sent to the authority | |
| filing_type_confidence | No | Confidence score (0.0–1.0) assigned by the automated classification system for the filing type. |