> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # Guidance > Get structured forward guidance from earnings releases. Returns ranges, point estimates, and directional signals. ## OpenAPI ````yaml openapi/financial.json GET /apis/v1/financial/kpi/guidance openapi: 3.1.0 info: description: '' title: FinancialAPI version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/financial/analyst-estimates - /apis/v1/financial/company/facts - /apis/v1/financial/company/facts/ticker - /apis/v1/financial/crypto/prices - /apis/v1/financial/crypto/prices/snapshot - /apis/v1/financial/earnings - /apis/v1/financial/earnings/press-releases - /apis/v1/financial/filings - /apis/v1/financial/filings/items - /apis/v1/financial/financial-metrics - /apis/v1/financial/financial-metrics/snapshot - /apis/v1/financial/financials - /apis/v1/financial/financials/balance-sheets - /apis/v1/financial/financials/cash-flow-statements - /apis/v1/financial/financials/income-statements - /apis/v1/financial/financials/search/line-items - /apis/v1/financial/financials/search/screener - /apis/v1/financial/financials/segmented-revenues - /apis/v1/financial/insider-trades - /apis/v1/financial/institutional-ownership - /apis/v1/financial/kpi/guidance - /apis/v1/financial/kpi/metrics - /apis/v1/financial/kpi/non-gaap - /apis/v1/financial/macro/interest-rates - /apis/v1/financial/macro/interest-rates/snapshot - /apis/v1/financial/news - /apis/v1/financial/prices - /apis/v1/financial/prices/snapshot x-aisa-document: facts_hash: e50cd45334c72588707922b805d9701775496b3503d0a3809c7462c18defa971 generator_version: '2' protocol_version: '1' schema_version: '1' composer_version: '13' response_pending: - operation_id: get_financial_analyst_estimates path: /apis/v1/financial/analyst-estimates method: GET statuses: - '200' reason: public success response has no authoritative payload declaration document_hash: sha256:92a2ebe1cedb3b29262bd2179cdd4fc2b204a165ec1e5de32c36a393740f9f66 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: financial x-aisa-catalogs: financial: title: FinancialAPI description: '' x-aisa-document: facts_hash: e50cd45334c72588707922b805d9701775496b3503d0a3809c7462c18defa971 generator_version: '2' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/financial/kpi/guidance: get: tags: - default summary: Guidance description: >- Get structured forward guidance from earnings releases. Returns ranges, point estimates, and directional signals. operationId: any_financial_apis_v1_financial_kpi_guidance parameters: - name: cursor in: query description: >- Opaque pagination cursor from a previous response's next_page_url. When provided, all other query parameters are ignored: the cursor carries the original request's filters. Treat it as opaque; do not construct or modify it. required: false schema: type: string - name: limit in: query description: >- Number of periods to return. This is the total across all pages, not a page size: each page holds up to 10 records, linked by `next_page_url`. required: false schema: type: integer default: 4 maximum: 50 - name: metric_name in: query description: Filter to a specific metric. required: false schema: type: string - name: period in: query description: 'Filter by period type: quarterly or annual.' required: false schema: type: string enum: - quarterly - annual default: quarterly - name: report_period_gte in: query description: Only return guidance on or after this date (YYYY-MM-DD). required: false schema: type: string format: date - name: report_period_lte in: query description: Only return guidance on or before this date (YYYY-MM-DD). required: false schema: type: string format: date - name: ticker in: query description: The ticker symbol. required: true schema: type: string responses: '200': description: Guidance response content: application/json: schema: $ref: '#/components/schemas/ResponseE40Feb4D3D6B_KPIGuidanceResponse' default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: ResponseE40Feb4D3D6B_KPIGuidanceResponse: type: object properties: kpi_guidance: type: array items: $ref: '#/components/schemas/ResponseE40Feb4D3D6B_KPIGuidanceItem' next_page_url: type: string description: >- Absolute URL of the next page of results. Present only when more results remain; request it as-is to continue. Each page holds up to 10 records. ResponseE40Feb4D3D6B_KPIGuidanceItem: type: object required: - ticker - metric_name - period - period_type properties: ticker: type: string example: DAL metric_name: type: string example: Operating Margin value: type: - number - 'null' unit: type: string example: '%' period: type: string example: Q2 2026 period_type: type: string enum: - quarterly - annual segment: type: - string - 'null' low: type: - number - 'null' description: Low end of guidance range. example: 6 high: type: - number - 'null' description: High end of guidance range. example: 8 point_estimate: type: - number - 'null' description: Single-point guidance when no range is given. prior_value: type: - number - 'null' description: Prior guidance value for revisions. raw_text: type: - string - 'null' description: Original guidance text from the filing. change_direction: type: - string - 'null' description: 'Direction: raised, lowered, maintained, initiated, withdrawn.' example: initiated source_text: type: - string - 'null' source_url: type: - string - 'null' format: uri securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.