---
title: "One block of a listed company's financial data, paid per call"
method: GET
path: "/api/companies/{company}/{block}"
tags: ["Company Briefings"]
---

# One block of a listed company's financial data, paid per call

`GET /api/companies/{company}/{block}`

## Request

- Base URL: `https://api.prereason.com`
- URL: `https://api.prereason.com/api/companies/{company}/{block}`
- Auth: HTTP bearer

One block of a listed company's financial data, such as its reported
figures or its valuation, paid per request with no API key.

One block of the company's briefing, as of today, from its public form,
with the company's name, address, market and the time the briefing was
computed. Nothing of the header block comes with another block: the
header is a block of its own. The whole briefing is
`GET /api/companies/{company}`.

A block name outside the list the `block` parameter takes is refused
with a 404 before any price is quoted. A block left out for this
company answers 404 `BLOCK_NOT_COVERED_YET`, and nothing is charged.

The numbers block alone takes a `date` (YYYY-MM-DD): its figures as
known at the end of that day in the company's market, each with
`knownBasis` (`filed`, `reported` or `deadline`) and `knownSince` (for
`deadline`, the date our deadline rule assumes). A period the store
cannot date is named and left out. Where the dated read is not
available the route answers 503 `DATED_READ_UNAVAILABLE`, and nothing
is charged.

Refused before any price is quoted, so no payment is taken: a `date`
on any other block, or a `time` (400: the figures carry their own
filing dates and the ratios keep no earlier version, so those blocks
are sold as of today), a malformed address (400), and an address
that names no company sold
here (404 `NOT_FOUND`) or one whose statements have not been read
(404 `NOT_COVERED_YET`). A key holder is never charged on this route:
the key's plan decides, as on `/api/context`.

## Path parameters

- `company` string, required
- `block` 'header' | 'what_changed' | 'situations' | 'against_guidance' | 'numbers' | 'segments' | 'valuation' | 'capital_structure' | 'quality' | 'profitability' | 'news', required

## Query parameters

- `date` string, date
- `format` 'json' | 'markdown'

## Response `200`

The block, Markdown by default, JSON with format=json

## Other responses

- `400`: A date or time was sent, or the address is malformed
- `401`: Authentication required
- `402`: Payment required. The body is an x402 v2 payment quote naming this resource, its price in USDC, and the accepted networks. Pay and retry with the payment header, or authenticate with an API key instead.
- `403`: A key whose plan does not reach the company's market
- `404`: No such block, no company briefing sold for this address, none of its statements read, or the block is not covered for this company
- `503`: The company could not be checked; no price was quoted and no payment taken

## Changes

- **2026-10-12** `7d724ae5ac5e`: 1 info
  - added the new optional `query` request parameter `date`
- **2026-10-03** `af8895edad72`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/prereason/apis/prereason-api/changes/api/companies/:company/:block/get.md)

---

[API](https://skmtc.dev/prereason/apis/prereason-api.md) - [All operations](https://skmtc.dev/prereason/apis/prereason-api/llms.txt) - [OpenAPI document](https://skmtc.dev/prereason/apis/prereason-api/revisions/fe5bacbc7887?raw)