> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rangler.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Company Calendar Events

> List company events within a date range, including board meetings, AGMs, and EGMs.

Requires paid access.



## OpenAPI

````yaml /openapi.json get /v1/calendar/events
openapi: 3.1.0
info:
  title: Rangler API
  version: 1.0.0
  description: >-
    Customer-facing Rangler API for companies, standardized financials, filings,
    funds, market data, events, and webhooks.
servers:
  - url: https://api.rangler.co
    description: Live
  - url: https://sandbox-api.rangler.co
    description: Sandbox
security: []
tags:
  - name: Analyst estimates
    description: Consensus forecasts, revisions, contributor accuracy, and source evidence.
  - name: Analyst recommendations
    description: Analyst ratings, target-price views, and company recommendation history.
  - name: Calendar
    description: Company events and calendar exports.
  - name: Companies
    description: >-
      Company lookup, issuer details, dividends, daily trades, meeting media,
      and mentions.
  - name: Events
    description: >-
      Read earlier events and check for missed deliveries across the market, a
      company, or a fund.
  - name: Financials
    description: >-
      Standardized financial statements, reported tables, ratios, and links to
      filing sources.
  - name: Filings
    description: Filings, board changes, insider dealings, and extracted filing mentions.
  - name: Funds
    description: Fund directories, disclosures, snapshots, holdings, and performance data.
  - name: Markets
    description: Market directories and regular-session clock data.
  - name: News
    description: Company news developments and company-filtered news search.
paths:
  /v1/calendar/events:
    get:
      tags:
        - Calendar
      summary: Get Company Calendar Events
      description: >-
        List company events within a date range, including board meetings, AGMs,
        and EGMs.


        Requires paid access.
      operationId: get_v1_calendar_events
      parameters:
        - name: from
          in: query
          required: true
          schema:
            type: string
            format: date
            title: From
        - name: to
          in: query
          required: true
          schema:
            type: string
            format: date
            title: To
        - name: market
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 2
                maxLength: 16
              - type: 'null'
            title: Market
        - name: type
          in: query
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
            title: Type
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
            title: Status
        - name: scope
          in: query
          required: false
          schema:
            enum:
              - all
              - tracked
            type: string
            default: all
            title: Scope
        - name: company_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Company Id
        - name: sector
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 128
              - type: 'null'
            title: Sector
        - name: q
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 100
              - type: 'null'
            title: Q
        - name: country_code
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filter by ISO 3166-1 alpha-2 market country code
            title: Country Code
          description: Filter by ISO 3166-1 alpha-2 market country code
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CompanyCalendarPage'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: unauthorized
                      code: unauthorized
                      message: Authentication required.
                      request_id: 28fa6152-7081-492e-8a7e-00beb237b689
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: forbidden
                      code: forbidden
                      message: Paid access is required.
                      request_id: 5c253b3e-778e-4a58-aaf8-07cb21e03563
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: validation_error
                      code: validation_error
                      message: Request validation failed
                      request_id: c5964dca-d290-4465-a3dc-f92d42aa9b17
                      details:
                        - type: missing
                          loc:
                            - query
                            - ticker
                          msg: Field required
                          input: null
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: rate_limit_exceeded
                      code: rate_limit_exceeded
                      message: Rate limit exceeded
                      request_id: cc4d369a-2c69-4ee2-909e-985ea35d14a9
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
              examples:
                default:
                  value:
                    error:
                      type: internal_server_error
                      code: internal_server_error
                      message: Internal Server Error
                      request_id: 70b63aba-b8a3-41c2-bb0c-fbe67d84d37d
      security:
        - RanglerApiKey: []
components:
  schemas:
    CompanyCalendarPage:
      properties:
        data:
          items:
            $ref: '#/components/schemas/CompanyCalendarEventRead'
          type: array
          title: Data
        summary:
          $ref: '#/components/schemas/CompanyCalendarSummaryRead'
        updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Updated At
      type: object
      required:
        - data
        - summary
      title: CompanyCalendarPage
    ErrorEnvelope:
      type: object
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/ErrorObject'
    CompanyCalendarEventRead:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        market:
          type: string
          title: Market
        event_type:
          type: string
          enum:
            - financial_results
            - board_meeting
            - agm
            - egm
            - corporate_action
            - earnings_forecast
          title: Event Type
        status:
          type: string
          enum:
            - scheduled
            - revised
            - reported
            - overdue
            - past
            - cancelled
          title: Status
        title:
          type: string
          title: Title
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        event_date:
          type: string
          format: date
          title: Event Date
        scheduled_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Scheduled Date
        scheduled_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Scheduled At
        actual_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Actual Date
        actual_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Actual At
        initial_scheduled_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Initial Scheduled Date
        revised_scheduled_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Revised Scheduled Date
        date_precision:
          type: string
          enum:
            - date
            - datetime
          title: Date Precision
        timezone:
          type: string
          title: Timezone
        fiscal_year:
          anyOf:
            - type: integer
            - type: 'null'
          title: Fiscal Year
        fiscal_period:
          anyOf:
            - type: string
            - type: 'null'
          title: Fiscal Period
        period_end:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Period End
        company:
          $ref: '#/components/schemas/CompanyCalendarCompanyRead'
        sources:
          items:
            $ref: '#/components/schemas/CompanyCalendarSourceRead'
          type: array
          title: Sources
        reported_filing_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Reported Filing Id
      type: object
      required:
        - id
        - market
        - event_type
        - status
        - title
        - event_date
        - date_precision
        - timezone
        - company
        - sources
      title: CompanyCalendarEventRead
    CompanyCalendarSummaryRead:
      properties:
        total:
          type: integer
          title: Total
        scheduled:
          type: integer
          title: Scheduled
        reported:
          type: integer
          title: Reported
        today:
          type: integer
          title: Today
        next_7_days:
          type: integer
          title: Next 7 Days
        busiest_day:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Busiest Day
        busiest_day_count:
          type: integer
          title: Busiest Day Count
      type: object
      required:
        - total
        - scheduled
        - reported
        - today
        - next_7_days
        - busiest_day_count
      title: CompanyCalendarSummaryRead
    ErrorObject:
      type: object
      required:
        - type
        - code
        - message
        - request_id
      properties:
        type:
          type: string
        code:
          type: string
        message:
          type: string
        request_id:
          type: string
        details:
          anyOf:
            - additionalProperties: true
              type: object
            - type: array
              items:
                additionalProperties: true
                type: object
            - type: 'null'
    CompanyCalendarCompanyRead:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        name:
          type: string
          title: Name
        ticker:
          type: string
          title: Ticker
        logo_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Logo Url
        sector:
          anyOf:
            - type: string
            - type: 'null'
          title: Sector
        exchange:
          anyOf:
            - type: string
            - type: 'null'
          title: Exchange
        market_cap_display:
          anyOf:
            - type: string
            - type: 'null'
          title: Market Cap Display
      type: object
      required:
        - id
        - name
        - ticker
      title: CompanyCalendarCompanyRead
    CompanyCalendarSourceRead:
      properties:
        kind:
          type: string
          title: Kind
        label:
          type: string
          title: Label
        external_id:
          type: string
          title: External Id
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
        published_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Published At
        effective_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Effective Date
        initial_scheduled_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Initial Scheduled Date
        revised_scheduled_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Revised Scheduled Date
        filing_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Filing Id
        signal_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Signal Id
      type: object
      required:
        - kind
        - label
        - external_id
      title: CompanyCalendarSourceRead
  securitySchemes:
    RanglerApiKey:
      type: apiKey
      in: header
      name: X-API-Key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.