> ## Documentation Index > Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt > Use this file to discover all available pages before exploring further. # Guidance > Returns company guidance data including forward-looking earnings and revenue projections provided by company management. Includes EPS guidance ranges (min/max), revenue guidance ranges, and comparisons to prior guidance. Guidance is crucial for understanding management's expectations for future performance. ```json Response (200 OK) theme={null} { "guidance": [ { "currency": "USD", "cusip": "00BMCD000", "date": "2026-01-05", "eps_guidance_est": "", "eps_guidance_max": "", "eps_guidance_min": "", "eps_guidance_prior_max": "", "eps_guidance_prior_min": "", "eps_type": "", "exchange": "NASDAQ", "id": "695bcc0c83cac20001becbd4", "importance": 1, "is_primary": "Y", "name": "RedCloud Holdings", "notes": "", "period": "FY", "period_year": 2026, "prelim": "Y", "revenue_guidance_est": "91170920.000", "revenue_guidance_max": "100000000.000", "revenue_guidance_min": "100000000.000", "revenue_guidance_prior_max": "100000000", "revenue_guidance_prior_min": "100000000.000", "revenue_type": "GAAP", "ticker": "RCT", "time": "09:30:00", "updated": 1767623735 } ] } ``` ```json Response (401 Unauthorized) theme={null} { "ok": false, "errors": [ { "code": "auth_failed", "id": "unauthorized", "value": "Invalid or missing authentication token" } ] } ``` ```json Response (404 Not Found) theme={null} { "ok": false, "errors": [ { "code": "no_data_found", "id": "not_found", "value": "No data found for the specified parameters" } ] } ``` ```json Response (500 Internal Server Error) theme={null} { "ok": false, "errors": [ { "code": "internal_server_error", "id": "server_error", "value": "An unexpected error occurred while processing your request" } ] } ``` ## OpenAPI ````yaml /openapi/calendar_api.spec.yml GET /api/v2.1/calendar/guidance openapi: 3.0.0 info: contact: {} description: >- This REST API returns structured data for conference calls, dividends, earnings (and future earnings dates), economics, pharmaceutical announcements, guidance, IPOs, secondary offerings, ratings, M&A activity, and splits. termsOfService: http://swagger.io/terms/ title: Calendar API version: 2.1.0 servers: - url: https://api.benzinga.com description: PROD security: [] paths: /api/v2.1/calendar/guidance: get: tags: - guidance summary: Returns guidance data description: >- Returns company guidance data including forward-looking earnings and revenue projections provided by company management. Includes EPS guidance ranges (min/max), revenue guidance ranges, and comparisons to prior guidance. Guidance is crucial for understanding management's expectations for future performance. operationId: get-guidance parameters: - description: >- Specifies return format. Query parameters work the same for both formats in: header name: accept required: true schema: type: string enum: - application/json default: application/json - description: >- Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date in: query name: page schema: type: integer default: 0 - description: Number of results returned. Limit 1000 in: query name: pagesize schema: type: integer - description: >- Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest in: query name: parameters[date] schema: type: string format: YYYY-MM-DD - description: Date to query from point in time in: query name: parameters[date_from] schema: type: string format: YYYY-MM-DD - description: Date to query to point in time in: query name: parameters[date_to] schema: type: string format: YYYY-MM-DD - description: >- The importance level to filter by. Uses Greater Than or Equal To the importance indicated in: query name: parameters[importance] schema: type: integer enum: - 0 - 1 - 2 - 3 - 4 - 5 - description: >- Determines if guidance returned is primary, secondary or all. Default set to Y in: query name: parameters[is_primary] schema: type: string enum: - 'Y' - 'N' - All default: 'Y' - description: One or more ticker symbols separated by a comma. Maximum 50 tickers in: query name: parameters[tickers] schema: type: string format: csv - description: >- Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated in: query name: parameters[updated] schema: type: integer responses: '200': description: success content: application/json: schema: $ref: '#/components/schemas/api.GuidanceResponse' text/xml: schema: $ref: '#/components/schemas/api.GuidanceResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/api.ErrorResponse' text/xml: schema: $ref: '#/components/schemas/api.ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/api.ErrorResponse' text/xml: schema: $ref: '#/components/schemas/api.ErrorResponse' security: - ApiKeyAuth: [] components: schemas: api.GuidanceResponse: description: API response containing an array of guidance records properties: guidance: items: $ref: '#/components/schemas/calendarapi.Guidance' type: array type: object api.ErrorResponse: properties: text: type: string type: object calendarapi.Guidance: properties: confirmed: type: boolean currency: example: USD type: string cusip: example: 37833100 type: string date: example: '2024-01-09' type: string eps_guidance_est: example: '1.55' type: string eps_guidance_max: example: '1.60' type: string eps_guidance_min: example: '1.50' type: string eps_guidance_prior_max: example: '1.45' type: string eps_guidance_prior_min: example: '1.35' type: string eps_type: example: GAAP type: string exchange: example: NASDAQ type: string id: example: 60a7f5e8e4b0f5a3c8e9f5b1 type: string importance: example: 4 type: integer is_primary: example: 'true' type: string name: example: Apple Inc. type: string notes: example: Raised guidance above analyst expectations type: string period: example: Q2 type: string period_year: example: 2024 type: integer prelim: example: 'false' type: string revenue_guidance_est: example: '93000000000' type: string revenue_guidance_max: example: '95000000000' type: string revenue_guidance_min: example: '91000000000' type: string revenue_guidance_prior_max: example: '89000000000' type: string revenue_guidance_prior_min: example: '87000000000' type: string revenue_type: example: GAAP type: string ticker: example: AAPL type: string time: example: '16:05:00' type: string updated: example: 1704819600 type: integer type: object securitySchemes: ApiKeyAuth: in: query name: token type: apiKey ````