Calendar
Earnings Calendar
/v2/calendar/earningsReturns upcoming and recent earnings events across all securities.
Included in: Growth.
Authentication
Send your API key in the x-api-key header on every request to https://api.bavest.co. The samples read it from the BAVEST_API_KEY environment variable. Get an API key (free trial) · Authentication guide.
Parameters
Optional, at most one of symbol, isin.
- string (date)query · no
Start date (YYYY-MM-DD)
- string (date)query · no
End date (YYYY-MM-DD)
- integer (int32)query · no
Maximum number of results to return (default 100, max 1000)
Default
100 - integer (int32)query · no
Number of results to skip for pagination (default 0)
Default
0 - stringquery · no
Opaque cursor for cursor-based pagination. When provided, returns results after the cursor position. Takes precedence over offset.
- stringquery · no (at most one of symbol, isin)
Only this security's events (e.g.,
BMW.DE). Omit for the whole calendar. Provide at most one of symbol or isin. - stringquery · no (at most one of symbol, isin)
Only this security's events, resolved to its primary listing (e.g.,
DE0005190003isBMW.DE). An unknown ISIN is 404. Omit for the whole calendar.
Response 200
Successful response · application/json
data- array of EarningsCalendarRecord
9 fields in data
eventType- string
Type of corporate event
Example:
earningsdate- string (date)
Event date
Example:
2026-05-27symbol- string
Ticker symbol
Example:
NVDAeps- number (double) | null
Actual earnings per share
Example:
0.89epsEstimated- number (double) | null
Estimated earnings per share
Example:
0.85revenue- number (double) | null
Actual revenue
Example:
44000000000revenueEstimated- number (double) | null
Estimated revenue
Example:
43500000000fiscalDateEnding- string (date) | null
Fiscal period end date
Example:
2026-04-30time- string | null
Time of day (bmo = before market open, amc = after market close)
One of:
bmoBefore market open
amcAfter market close
dmhDuring market hours
Example:
bmo
meta- ResponseMeta
Response metadata for paginated endpoints. Offset pagination returns
page/pageSize/totalPages/totalCount; cursor pagination returnspageSize/hasMore/nextCursorandtotalCountonly when known.8 fields in meta
time- integer
Server-side processing time in milliseconds
Example:
17parameters- object
Echo of the request parameters the endpoint resolved
page- integer
Current page number (offset pagination)
Example:
1pageSize- integer
Number of results per page
Example:
50totalPages- integer
Total number of pages (offset pagination)
Example:
2totalCount- integer
Total number of results across all pages
Example:
100hasMore- boolean
Whether more results follow (cursor pagination)
nextCursor- string | null
Cursor for the next page (cursor pagination), null on the last page
Errors
- 400 Invalid 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).
- 401 Missing or invalid API key.
- 404 Resource not found.
- 429 Rate limit exceeded. Retry after the `Retry-After` header interval.
- 500 An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
- 502 Upstream data provider returned an error or is temporarily unavailable. Retry after a short delay.
- 504 The request timed out waiting for a response from the upstream data provider. This may occur for complex queries or during peak load.
- default An unexpected error occurred on the server. If the issue persists, contact support with the X-Request-Id header value.
403from the gateway: the API key is invalid or switched off.429with messageLimit Exceeded: the monthly quota of the key is used up. WithToo Many Requests: the key is throttled, or this route is not in the key's plan. Wait forRetry-Afterwhen it is sent.

