---
title: "Company financials from XBRL"
method: GET
path: "/api/markets/financials"
tags: ["Companies"]
---

# Company financials from XBRL

`GET /api/markets/financials`

## Request

- Base URL: `https://xoomar.com`
- URL: `https://xoomar.com/api/markets/financials`
- Auth: one of:
  - none
  - API key in header `x-api-key`

Quarterly and annual income figures and the balance sheet for one ticker. Docs: https://xoomar.com/markets/api/financials

## Query parameters

- `symbol` string, required

## Response `200`

OK

- object
  - `data` object
    - `quarterly` object[]: Quarterly income rows, oldest first
      - `frame` string: Calendar quarter frame, e.g. CY2026Q2 (three-month figures); CY2025Q4 with derived=true is fiscal year less the three reported quarters
      - `fiscalPeriod` string, nullable: The quarter as the company names it, e.g. Q2 FY 2027 for NVIDIA's quarter ended 26 Jul 2026; null when the company's fiscal calendar isn't on file
      - `fiscalYear` string, nullable: The quarter's fiscal year as the annual rows name it, e.g. FY 2027
      - `derived` boolean: true for a computed fourth quarter (EPS left empty)
      - `revenue` number, nullable: Revenues or RevenueFromContractWithCustomerExcludingAssessedTax, USD
      - `netIncome` number, nullable: NetIncomeLoss, USD
      - `epsDiluted` number, nullable: EarningsPerShareDiluted (basic when diluted is absent)
      - `canonicalUrl` string, uri: The matching page on xoomar.com
    - `annual` object[]: Fiscal year rows, oldest first
      - `fiscalYear` string: The fiscal year as the company names it in its annual report, e.g. FY 2026 for NVIDIA's year ended 25 Jan 2026
      - `operatingCashFlow` number, nullable: NetCashProvidedByUsedInOperatingActivities for the fiscal year
      - `capex` number, nullable: Capital expenditure for the fiscal year, USD: PaymentsToAcquirePropertyPlantAndEquipment, or the element the company files it as (PaymentsToAcquireProductiveAssets and others)
      - `buybacks` number, nullable: PaymentsForRepurchaseOfCommonStock for the fiscal year, USD
      - `dividends` number, nullable: PaymentsOfDividendsCommonStock or PaymentsOfDividends, USD
      - `canonicalUrl` string, uri: The matching page on xoomar.com
    - `latest.cash` number, nullable: Balance sheet instants at latest.end
    - `latest.debt` number, nullable: Balance sheet instants at latest.end
    - `latest.equity` number, nullable: Balance sheet instants at latest.end
    - `latest.assets` number, nullable: Balance sheet instants at latest.end
    - `latest.sharesOutstanding` number, nullable: Cover-page shares outstanding at latest.sharesDate
    - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `updatedAt` string, date-time: When the response was built; a few dated feeds give the date of their newest row instead
  - `source` 'xoomar.com'
  - `docs` string
  - `license` string: Data terms
  - `attribution` string
  - `canonicalUrl` string, uri: The matching page on xoomar.com
  - `meta` object: Who publishes the data and how to credit it
    - `source` string: The publisher or publishers of the data, comma-separated
    - `sourceAttribution` string: The credit line to show wherever the data is displayed
    - `notice` string: Requests without a key only: the free key, app registration and the credit

## Other responses

- `404`: Unknown slug, ticker or country
- `429`: Rate limit: 10 requests a minute without a key, 30 with a free key

---

[API](https://skmtc.dev/xoomar/apis/xoomar-market-data-api.md) · [All operations](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xoomar/apis/xoomar-market-data-api/revisions/07b78401eaaa?raw)