import requests resp = requests.post( "https://api.oab-forecasting.com/forecast-jobs", headers={"Authorization": "Bearer YOUR_API_KEY"}, json={ "series": [{"index": ["2023-01-01","2023-02-01","2023-03-01"], "target": [120.5, 122.3, 119.8]}], "model": "moirai-2", "horizon": 12, "freq": "MS", }, ) print(resp.json()["job_id"]) # bal-8fa8073193164cd2

POSTapi.oab-forecasting.com/forecast-jobs

Submit Forecast Job

Submit a long-running forecast asynchronously. Returns a job_id immediately. Poll GET /forecast-jobs/{job_id} until status is "completed".

Request Schema

seriesarray[object]requiredOne or more time-series objects.

[item]object

targetarray[number]requiredThe time-series values to forecast from.

indexarray[string]requiredISO date strings matching target length.

hist_variablesobjectoptionalHistorical covariate columns. Keys are variable names, values are arrays same length as target.

future_variablesobjectoptionalFuture covariate columns. Keys are variable names, values are arrays of length horizon.

future_variables_indexarray[string]optionalISO date strings for future_variables, length = horizon.

static_variablesobjectoptionalStatic scalar covariates. Each key maps to a single value.

horizonintegerrequiredNumber of steps to forecast. Range: 1–10000.

freqstring (enum)required5min · 15min · 30min · H · D · W · M · MS · Q · Y

contextintegeroptionalHistory steps to use. Default: min(model_max, series_length).

quantilesarray[number]optionalQuantiles to return. Default: [0.1, 0.5, 0.9].

model_sizestringoptionalSize variant for multi-size models (chronos, chronos-2). e.g. "base".

Response Schema

job_idstringUUID identifying the async job. Use with GET /forecast-jobs/{job_id}.

statusstring (enum)in_progress · completed · failed

Response Example

{
  "job_id": "job_4f8a1c2d3e5b6a7f",
  "status": "in_progress"
}

Possible Errors

401UnauthorizedMissing or invalid Authorization header

422UnprocessableValidation failure. Check the detail field.

500Server ErrorJob submission failure