Aiera

Aiera Calendar API

The Calendar API from Aiera — 3 operation(s) for calendar.

Documentation GitHub OpenAPI

Operations 3

GET /calendar Retrieves a calendar object #

GET /calendar/coverage Get Equities Coverage #

GET /calendar/{event_id} Get Calendar Event by ID #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/aiera-calendar-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Aiera Calendars Calendar API
  description: API for accessing calendar data from Aiera
  version: 1.0.0
servers:
- url: https://premium.aiera.com/api
security:
- ApiKeyAuth: []
tags:
- name: Calendar
paths:
  /calendar:
    get:
      security:
      - ApiKeyAuth: []
      operationId: getCalendar
      summary: Retrieves a calendar object
      description: Fetch calendar events filtered by equity, watchlist, or other parameters.
      parameters:
      - name: modified_since
        in: query
        required: false
        description: Returns events modified since this date.
        schema:
          type: string
          format: date-time
          example: '2024-10-31T23:59:59.999999'
      - name: event_type
        in: query
        required: false
        description: Filter by event type.
        schema:
          type: string
          default: earnings
      - name: start_date
        in: query
        description: Fetch events on or after this date (defaults to 2 weeks ago)
        required: false
        schema:
          type: string
          format: date-time
      - name: end_date
        in: query
        description: Fetch events on or before this date (defaults to 2 weeks from now)
        required: false
        schema:
          type: string
          format: date-time
      - name: bloomberg_ticker
        in: query
        required: true
        description: Filter events to 1+ bloomberg tickers always including country codes with colon (comma-separated).
        schema:
          type: string
      - name: isin
        in: query
        required: false
        description: Filter events to ISINs (comma-separated).
        schema:
          type: string
      - name: permid
        in: query
        required: false
        description: Filter events to PermID identifiers (comma-separated).
        schema:
          type: string
      - name: ric
        in: query
        required: false
        description: Filter events to Reuters RICs (comma-separated).
        schema:
          type: string
      - name: ticker
        in: query
        required: false
        description: Filter events to local tickers (comma-separated).
        schema:
          type: string
      - name: watchlist_id
        in: query
        required: false
        description: Filter events to watchlist IDs (comma-separated).
        schema:
          type: integer
      - name: company_rollup
        in: query
        required: false
        description: Whether to roll up matches to the company entity.
        schema:
          type: boolean
      - name: include_deleted
        in: query
        required: false
        description: Whether to include deleted event records.
        schema:
          type: boolean
      - name: include_private
        in: query
        required: false
        description: Whether to include private events.
        schema:
          type: boolean
      - name: from_index
        in: query
        required: false
        description: Index to start returning results from.
        schema:
          type: integer
      - name: size
        in: query
        required: false
        description: Number of events to return, max 1000.
        schema:
          type: integer
      - name: sort_key
        in: query
        required: false
        description: Sort results by event_id_asc, event_id_desc, event_date_asc (default), or event_date_desc.
        schema:
          type: string
      responses:
        '200':
          description: A calendar object
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Calendar'
        default:
          description: unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      tags:
      - Calendar
  /calendar/coverage:
    get:
      summary: Get Equities Coverage
      description: Retrieve information about equities covered by the API.
      operationId: getCalendarCoverage
      parameters:
      - name: bloomberg_ticker
        in: query
        description: Filter events to 1+ bloomberg tickers always including country codes with colon (comma-separated).
        required: false
        schema:
          type: string
      - name: isin
        in: query
        description: ISIN filter.
        required: false
        schema:
          type: string
      - name: cusip
        in: query
        description: CUSIP filter.
        required: false
        schema:
          type: string
      - name: ric
        in: query
        description: Reuters/Refinitiv RIC filter.
        required: false
        schema:
          type: string
      - name: ticker
        in: query
        description: Ticker filter.
        required: false
        schema:
          type: string
      - name: permid
        in: query
        description: PermID filter.
        required: false
        schema:
          type: string
      - name: watchlist_id
        in: query
        description: Watchlist ID filter.
        required: false
        schema:
          type: integer
      - name: company_rollup
        in: query
        description: Rollup to all company equities.
        required: false
        schema:
          type: boolean
      responses:
        '200':
          description: Equities coverage details.
          content:
            application/json:
              schema:
                type: object
                properties:
                  counts:
                    type: object
                  results:
                    type: object
      tags:
      - Calendar
  /calendar/{event_id}:
    get:
      summary: Get Calendar Event by ID
      operationId: getCalendarById
      description: Retrieve details of a specific calendar event by its ID.
      parameters:
      - name: event_id
        in: path
        description: The unique identifier of the event.
        required: true
        schema:
          type: integer
      responses:
        '200':
          description: Calendar event details.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/EventDetails'
      tags:
      - Calendar
components:
  schemas:
    EventDetails:
      type: object
      properties:
        modified:
          type: string
          format: date-time
        created:
          type: string
          format: date-time
        event_id:
          type: integer
        event_title:
          type: string
        event_type:
          type: string
        event_date:
          type: string
          format: date-time
        equity:
          $ref: '#/components/schemas/Event'
        broadcast_url:
          type: string
        replay_url:
          type: string
        conference_number:
          type: string
        conference_pin:
          type: string
        slides_url:
          type: string
        press_url:
          type: string
        transcription_audio_url:
          type: string
    Error:
      type: object
      required:
      - code
      - message
      properties:
        code:
          type: integer
          format: int32
        message:
          type: string
    Event:
      type: object
      properties:
        event_id:
          type: integer
        event_title:
          type: string
        event_type:
          type: string
        event_date:
          type: string
          format: date-time
          example: '2024-10-31T23:59:59.999999'
          pattern: ^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{6}$
        equity:
          type: object
          properties:
            equity_id:
              type: integer
            local_ticker:
              type: string
            bloomberg_ticker:
              type: string
            ric:
              type: string
            permid:
              type: string
            isin:
              type: string
            exchange_mic:
              type: string
    Calendar:
      type: object
      properties:
        params:
          type: object
        count:
          type: integer
        events:
          type: array
          items:
            $ref: '#/components/schemas/Event'
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY