> ## Documentation Index > Fetch the complete documentation index at: https://docs.qfex.com/llms.txt > Use this file to discover all available pages before exploring further. # Earnings and Economic Calendar > Return company earnings and economic events for an inclusive date range of up to 93 days. No authentication is required. Earnings use report dates; economic events use their stored calendar dates. For timezone-aware weekly displays, include one extra date on either side and group exact release timestamps in the desired timezone. Unknown release times remain null. Economic sync freshness is returned separately from earnings. Earnings metadata omits source attribution fields, including nested release-time sources. Pin api_version=2026-10-29 to retain the historical metadata. ## OpenAPI ````yaml https://api.qfex.com/openapi.yaml get /calendar openapi: 3.1.0 info: contact: email: support@qfex.com name: QFEX Support description: REST API for QFEX license: name: QFEX License url: https://qfex.com/license title: QFEX REST API version: '2026-10-30' servers: - description: Production server url: https://api.qfex.com security: [] paths: /calendar: get: tags: - market-data summary: Earnings and Economic Calendar description: >- Return company earnings and economic events for an inclusive date range of up to 93 days. No authentication is required. Earnings use report dates; economic events use their stored calendar dates. For timezone-aware weekly displays, include one extra date on either side and group exact release timestamps in the desired timezone. Unknown release times remain null. Economic sync freshness is returned separately from earnings. Earnings metadata omits source attribution fields, including nested release-time sources. Pin api_version=2026-10-29 to retain the historical metadata. operationId: read-calendar parameters: - description: First report/event date, inclusive (YYYY-MM-DD). explode: false in: query name: from required: true schema: description: First report/event date, inclusive (YYYY-MM-DD). format: date type: string - description: Last report/event date, inclusive. Maximum 93 days per request. explode: false in: query name: to required: true schema: description: Last report/event date, inclusive. Maximum 93 days per request. format: date type: string - description: >- Published API contract date. Omit or use latest for the latest contract; explicit dates stay pinned. Applies to request validation and response format. in: query name: api_version schema: examples: - '2026-10-30' type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/CalendarData' description: OK headers: Cache-Control: schema: type: string default: content: application/problem+json: schema: $ref: '#/components/schemas/ErrorModel' description: Error security: [] components: schemas: CalendarData: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - >- https://api.qfex.com/contracts/2026-10-30/schemas/CalendarData.json format: uri readOnly: true type: string earnings: items: $ref: '#/components/schemas/CalendarEarnings' type: - array - 'null' economic: $ref: '#/components/schemas/CalendarEconomicData' required: - earnings - economic type: object ErrorModel: additionalProperties: false properties: $schema: description: A URL to the JSON Schema for this object. examples: - https://api.qfex.com/contracts/2026-10-30/schemas/ErrorModel.json format: uri readOnly: true type: string detail: description: >- A human-readable explanation specific to this occurrence of the problem. examples: - Property foo is required but is missing. type: string errors: description: Optional list of individual error details items: $ref: '#/components/schemas/ErrorDetail' type: - array - 'null' instance: description: >- A URI reference that identifies the specific occurrence of the problem. examples: - https://example.com/error-log/abc123 format: uri type: string status: description: HTTP status code examples: - 400 format: int64 type: integer title: description: >- A short, human-readable summary of the problem type. This value should not change between occurrences of the error. examples: - Bad Request type: string type: default: about:blank description: A URI reference to human-readable documentation for the error. examples: - https://example.com/errors/example format: uri type: string type: object CalendarEarnings: additionalProperties: false properties: body: type: - string - 'null' eps_actual: format: double type: - number - 'null' eps_estimate: format: double type: - number - 'null' id: type: string metadata: additionalProperties: {} type: object report_date: format: date type: string revenue_actual: format: double type: - number - 'null' revenue_estimate: format: double type: - number - 'null' symbol: type: string title: type: - string - 'null' required: - id - symbol - report_date - metadata - title - body - eps_estimate - eps_actual - revenue_estimate - revenue_actual type: object CalendarEconomicData: additionalProperties: false properties: events: items: $ref: '#/components/schemas/CalendarEconomicEvent' type: - array - 'null' fetchedAt: description: >- Last successful economic calendar sync, or null before the first sync. format: date-time type: - string - 'null' stale: description: >- True before the first sync or when the last sync is over one hour old. type: boolean required: - events - fetchedAt - stale type: object ErrorDetail: additionalProperties: false properties: location: description: >- Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id' type: string message: description: Error message text type: string value: description: The value at the given location type: object CalendarEconomicEvent: additionalProperties: false properties: actual: description: Number, formatted string, or null when unavailable. consensus: description: Number, formatted string, or null when unavailable. country: description: Two-letter country/region code; EU denotes the euro area. type: string data_stale: type: boolean date: format: date type: string id: type: string impact: type: - string - 'null' last_verified_at: type: - string - 'null' name: type: string period: type: - string - 'null' prior: description: Number, formatted string, or null when unavailable. release_at_utc: format: date-time type: - string - 'null' release_stage: type: - string - 'null' series_code: type: string source_name: type: - string - 'null' source_url: type: - string - 'null' status: type: string unit: type: - string - 'null' url: type: - string - 'null' required: - id - series_code - name - country - date - release_at_utc - impact - status - period - release_stage - consensus - prior - actual - unit - source_url - source_name - url - data_stale - last_verified_at type: object ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.