v1
latestOpenAPI 3.0.02026-07-266091181.5 KBReturns guidance data
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.
Query parameters
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
Number of results returned. Limit 1000
Date to query for calendar data. Shorthand for date_from and date_to if they are the same. Defaults for latest
Date to query from point in time
Date to query to point in time
The importance level to filter by. Uses Greater Than or Equal To the importance indicated
Determines if guidance returned is primary, secondary or all. Default set to Y
One or more ticker symbols separated by a comma. Maximum 50 tickers
Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated
Headers
Specifies return format. Query parameters work the same for both formats
Response
success
Example response
{
"guidance": [
{
"currency": "USD",
"date": "2024-01-09",
"eps_guidance_est": "1.55",
"eps_guidance_max": "1.60",
"eps_guidance_min": "1.50",
"eps_guidance_prior_max": "1.45",
"eps_guidance_prior_min": "1.35",
"eps_type": "GAAP",
"exchange": "NASDAQ",
"id": "60a7f5e8e4b0f5a3c8e9f5b1",
"importance": 4,
"is_primary": "true",
"name": "Apple Inc.",
"notes": "Raised guidance above analyst expectations",
"period": "Q2",
"period_year": 2024,
"prelim": "false",
"revenue_guidance_est": "93000000000",
"revenue_guidance_max": "95000000000",
"revenue_guidance_min": "91000000000",
"revenue_guidance_prior_max": "89000000000",
"revenue_guidance_prior_min": "87000000000",
"revenue_type": "GAAP",
"ticker": "AAPL",
"time": "16:05:00",
"updated": 1704819600
}
]
}