Entities

Cross-period side-by-side of two fiscal years for the same entity

Compares two FISCAL YEARS of the SAME entity side-by-side ("what changed at Apple between FY23 and FY24?"). Returns a per-concept matrix with deltas and the semantic-change flags is_new_in_b / is_removed_in_b / is_sign_flip / has_restatement_warning.

It compares two years as served, not two filings as filed: each cell is the value served for that year, whichever filing published it. The filing_a / filing_b references identify the year, they do not restrict the figures to those documents.

Query params :

  • fiscal_year_a / fiscal_year_b (required) — auto-swapped so a is the older year.
  • hub_concept_codes (repeatable) — restrict the matrix to these hubs (up to 50). Omit for the 25 curated primary hubs.
  • form_type (default: the most recent original annual filing) and fiscal_period_type (default FY).

DIFFERENT from POST /compare (cross-entity, one year) and /restatements/diff (10-K vs 10-K/A).

get/api/v1/entities/{entity_id}/compare-filings

Request

  • Base URL: https://api.hub-equity.com
  • URL: https://api.hub-equity.com/api/v1/entities/{entity_id}/compare-filings
  • Auth: HTTP bearer

Path parameters

entity_idstring required

Query parameters

fiscal_year_ainteger required

First fiscal year (older).

fiscal_year_binteger required

Second fiscal year (newer).

hub_concept_codesstring[] nullable

Repeatable. Restrict to these hub concept codes (up to 50). Omit for the 25 curated primary hubs.

form_typestring nullable

Form of the reference filing of each year (10-K, 20-F, 40-F, annual_report for ESEF, or an amendment such as 10-K/A). Omit for the most recent original annual filing of each year.

fiscal_period_typestring

FY (default, annual), Q1-Q4, or H1/H2.

Response

The cross-period comparison matrix.

successboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.