For AI agents: complete Markdown index · compact index. Follow the explicit .md links for the Markdown version of each page.

Calendar

Earnings Calendar

GET/v2/calendar/earnings

Returns 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., DE0005190003 is BMW.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: earnings

    • date
      string (date)

      Event date

      Example: 2026-05-27

    • symbol
      string

      Ticker symbol

      Example: NVDA

    • eps
      number (double) | null

      Actual earnings per share

      Example: 0.89

    • epsEstimated
      number (double) | null

      Estimated earnings per share

      Example: 0.85

    • revenue
      number (double) | null

      Actual revenue

      Example: 44000000000

    • revenueEstimated
      number (double) | null

      Estimated revenue

      Example: 43500000000

    • fiscalDateEnding
      string (date) | null

      Fiscal period end date

      Example: 2026-04-30

    • time
      string | null

      Time of day (bmo = before market open, amc = after market close)

      One of:

      bmo

      Before market open

      amc

      After market close

      dmh

      During market hours

      Example: bmo

  • meta
    ResponseMeta

    Response metadata for paginated endpoints. Offset pagination returns page/pageSize/totalPages/totalCount; cursor pagination returns pageSize/hasMore/nextCursor and totalCount only when known.

    8 fields in meta
    • time
      integer

      Server-side processing time in milliseconds

      Example: 17

    • parameters
      object

      Echo of the request parameters the endpoint resolved

    • page
      integer

      Current page number (offset pagination)

      Example: 1

    • pageSize
      integer

      Number of results per page

      Example: 50

    • totalPages
      integer

      Total number of pages (offset pagination)

      Example: 2

    • totalCount
      integer

      Total number of results across all pages

      Example: 100

    • hasMore
      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.
  • 403 from the gateway: the API key is invalid or switched off.

  • 429 with message Limit Exceeded: the monthly quota of the key is used up. With Too Many Requests: the key is throttled, or this route is not in the key's plan. Wait for Retry-After when it is sent.

For AI agents: this page as Markdown at /docs/v2_calendar_earnings.md, every route in /llms.txt, the OpenAPI spec at /openapi.json.