Earnings releases

GET /v1/companies/{id}/earnings-releases
GET /v1/companies/{id}/earnings-releases/{accession}

The press-release exhibit furnished with each 8-K that includes Item 2.02 (Results of Operations and Financial Condition). The list is sorted newest filed first and has no text. The detail route returns one release with its plain text. We don’t extract figures from the text.

curl -H "X-API-Key: $BELFORT_API_KEY" \
  "https://belfort-data-api.vercel.app/v1/companies/AAPL/earnings-releases?limit=20"

curl -H "X-API-Key: $BELFORT_API_KEY" \
  "https://belfort-data-api.vercel.app/v1/companies/AAPL/earnings-releases/0000320193-25-000001"

Parameters

Parameter	Values	Default
limit	1–100 releases per page.	20
cursor	The previous page’s meta.next_cursor.
from	Earliest filed date to include, YYYY-MM-DD.
to	Latest filed date to include, YYYY-MM-DD.

The detail route takes the accession in the path, in the form ##########-##-######.

One release

Field	Meaning
accession	The 8-K filing the exhibit came from.
filed	The day the filing was made.
period	The period the release reports on.
title	The release’s title, or null. See below.
title_source	How the title was produced, such as llm_verified.
exhibit_type, exhibit_description	The exhibit’s type and description as filed, such as EX-99.1.
items	The 8-K item numbers the filing reports, such as 2.02 and 9.01.
exhibit_url	The exhibit on EDGAR.
filing_url	The filing’s index page on EDGAR.
text	The exhibit as plain text. Only on the detail route.

What to expect

• Coverage starts on 2024-01-01.
• No figures are extracted. You get the release as the company wrote it.
• Not every Item 2.02 exhibit is an earnings release. Some are slide decks, call transcripts or other announcements. Use exhibit_description, exhibit_type and items to tell them apart.
• Titles are proposed by an AI model and verified word for word against the exhibit text. A title can be null. The measured check is on Quality.
• The list has no text. Call the detail route for the text of one release.