Filings

Retrieve Filing Details

Access Level Required: Requires Standard Access (Level 1).

Retrieve detailed information for a single filing by its ID.

get/filings/{id}/

Request

  • Base URL: https://api.financialreports.eu
  • URL: https://api.financialreports.eu/filings/{id}/
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idinteger required

A unique integer value identifying this filing.

Response

Success

idinteger required

Unique identifier for the filing.

filing_datestring date required

The official date of the filing (soon to be deprecated).

titlestring

Optional title for the filing

added_to_platformstring date-time required

Date and time when the filing was added to our platform

updated_datestring date-time required

The date and time this filing record was last modified.

dissemination_datetimestring date-time nullable

Time the document was released to the public and sent to the authority

release_datetimestring date-time nullable

Time the document was published on the authority page

documentstring uri nullable required

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.

proxy_urlstring uri nullable required

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.

viewer_urlstring uri nullable required

URL to view the filing in the interactive web platform.

file_extensionstring nullable

File extension (e.g., PDF, HTML).

file_sizeinteger nullable

File size in bytes.

markdown_urlstring uri nullable required

API link to the filing's full text as Markdown. Null until a Markdown version is available (see processing_status).

processing_status'PENDING' | 'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'SKIPPED'
  • PENDING - Pending
  • QUEUED - Queued
  • PROCESSING - Processing
  • COMPLETED - Completed
  • FAILED - Failed
  • SKIPPED - Skipped
filing_type_confidencenumber double nullable required

Confidence score (0.0–1.0) assigned by the automated classification system for the filing type.

filing_type_reasoningstring nullable required

Step-by-step rationale produced by the automated classification system for the assigned filing type. Indicative only — not manually reviewed.

language_confidencenumber double nullable required

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_atstring date-time nullable required

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.

fiscal_yearinteger nullable required

The accounting fiscal year this filing covers (e.g., 2024). Populated for annual, quarterly, interim reports and earnings releases. Null if not yet determined.

period_ending_datestring date nullable required

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.

ingestion_mode'REALTIME' | 'BACKFILLED' required
  • REALTIME - Realtime
  • BACKFILLED - Backfilled
source_urlstring uri nullable required

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.

source_filing_typestring nullable required

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.

source_filing_idstring nullable required

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.

Changes

No recorded changes to this operation across all 2 revisions of this API.