Earnings Release Filings

get

https://api.bavest.co/v2/filings/earnings

Real-time feed of SEC 8-K earnings-release filings (item 2.02), source-
agnostic and forward-compatible with future push delivery (websocket /
webhook). Each event is written twice: once at stage=announced
(lowest latency, minimal fields — typically seconds after the filing
hits EDGAR) and again at stage=enriched once the index page and
press-release exhibit have been hydrated.

Omit symbol/isin/cusip for the full firehose across all
companies. from/to filter on filed_at. For low-latency polling,
use updated_since instead of from/to: it switches the sort order
to updated_at ascending so a cursor never skips a row that was
updated between polls (e.g. an announced row that became
enriched). Ordered filed_at DESC by default, updated_at ASC when
updated_since is set.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

symbol

string

Optional ticker filter (e.g., AAPL). Omit for all securities. Provide at most one of symbol or isin.

isin

string

length between 12 and 12

^[A-Z]{2}[A-Z0-9]{9}[0-9]$

ISIN code (e.g., US0378331005). Provide exactly one of symbol or isin. Clear the symbol example before using an ISIN.

cusip

string

length between 9 and 9

CUSIP code (e.g., 037833100). Provide at most one of symbol, isin, or cusip.

from

date

Start date (YYYY-MM-DD)

date

End date (YYYY-MM-DD)

updated_since

date-time

Delta-polling cursor start. Accepts an ISO-8601 date or date-time. When set, results are sorted updated_at ascending instead of filed_at descending — the recommended low-latency polling pattern, since it guarantees a cursor never skips a row that was updated between polls.

limit

int32

1 to 500

Defaults to 50

Maximum number of results to return (default 50, max 500)

cursor

string

Opaque cursor for cursor-based pagination. When provided, returns results after the cursor position. Takes precedence over offset.

Responses

Language

Credentials

Header

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Successful response

400Invalid request parameters. Returned when required query parameters are missing, have invalid types, or violate constraints (e.g., providing both symbol and isin when they are mutually exclusive).

401Missing or invalid API key.

404Resource not found.

429Rate limit exceeded. Retry after the Retry-After header interval.

500An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.

502Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay.

504The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load.

defaultAn unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.