v1

latestOpenAPI 3.1.02026-07-2342137210.8 KB
Models

Search Models

Returns a paginated list of forecast models belonging to the authenticated organization. Supports full-text search across name, label, and external_id via the q parameter, and filtering by Saved Location ID and readiness status.

get/v1/forecasts/models

Query parameters

qstring

Fulltext search across name, label and external_id.

location.saved_location_idstring[]

A comma-separated list of Saved Location IDs to filter on.

readiness_statusstring[]

A comma-separated list of forecast model statuses to filter on.

  • created: Model has been created but not yet trained.
  • preparing: Model is locked and gathering data prior to training.
  • training: Model is currently being trained on uploaded demand data.
  • forecasting: Model is generating forecasts.
  • ready: Model has successfully generated forecasts and is available for queries.
  • stale: Model configuration or data has changed; retraining is required.
  • failed: Processing encountered an error.
limitinteger

Maximum number of results to return per page.

offsetinteger

Zero-based index of the first result to return.

Response

Successful Response

errorsstring[]

List of error messages, if any.

warningsstring[]

List of warning messages, if any.

countinteger required

Total number of results matching the query.

nextstring nullable

URL for the next page of results. Null if no more results.

previousstring nullable

URL for the previous page of results. Null if on the first page.