Overview
Welcome to The Forecasting Company API. We expose our own models, as
well as other open-source foundation models, behind a unified REST API at
https://api.retrocast.com.
This page gets you to a first forecast: a quick start, authentication and the available models. The rest of the documentation:
- Concepts, how the column schema, selectors, hierarchies and backtests fit together, with interactive examples.
- Cookbook, complete, runnable requests for common tasks: several targets, roll-ups, backtests, parquet files, covariates.
- Error handling, what each error means and which ones to retry.
- API Reference, every field, parameter and error status.
Quick start
Daily sales for one store, forecast two weeks ahead:
Code
input.source holds the data, here inline with one array per column.
input.columns gives each column a role: date is the time axis, store
identifies a series, sales is the value to forecast. Each distinct store
is one series.
The response has one entry per series and forecast step. The arrays below are trimmed to the first two of the 14 steps:
Code
Authentication
Every request needs an API key, sent as a Bearer token. Create one on the API Keys page.
Code
Available models
The model query parameter is required; a request without it is rejected
with missing field "model". t0-gamma is our latest model.
To pass options to the model, put them in the request's model_config field.
They go to the model as given: each model defines which options it takes, and
rejects the ones it doesn't know.
| Model | Description |
|---|---|
t0-gamma | The Forecasting Company's latest model |
t0-beta | The Forecasting Company's previous model |
t0-alpha | The Forecasting Company's first model |
chronos-2 | Amazon's Chronos-2 |
timesfm-2p5 | Google's TimesFM 2.5 |
tirex | NXAI's model based on xLSTMs |
toto2 | Datadog's Toto v.2 |
tabpfn-2 | Foundation model from Uni. of Freiburg |
tabicl | TabICL, a tabular in-context learner |
aarima | Auto-ARIMA |
aets | Auto-ETS |
naive | Seasonal naive baseline |
Questions? Email [email protected].

