latestOpenAPI 3.0.12026-08-1163117239.4 KB

c5ac8232e334

ForecastModel

Retrieves the list of accessible forecast models for the user

Retrieves the list of accessible forecast models for the user

get/forecastmodels

Query parameters

tagsstring[]

Provide of list of tags to filter by. Only models with at least one of the provided tags will be returned

statesModelState[]

Provide a list of states to filter by. Only models with one of the provided states will be returned. Hold CTRL or Command key to select multiple model states

        0 = Draft
        

        1 = Archive
        

        2 = Production
generateSummaryboolean

If true, generates a brief summary of each model. This will increase the time for a response by 7 seconds per model.

Response

OK

idstring uuid

The id of the model.

namestring nullable

The name of the model.

descriptionstring nullable

The description of the model.

createdstring date-time

The timestamp in UTC for when the model was created.

lastModifiedstring date-time

The timestamp in UTC when the model was last saved.

ownerstring nullable

The username of the owner of the model.

companyNamestring nullable

The name of the company the model belongs to.

companyPrefixstring nullable

The prefix of the company. A shortened name in the application which is used to differentiate between companies.

calculation0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8

The transformation applied to the data.

Possible options:

None 1

PeriodOverPeriod 2

YearOverYear 3

ThreePeriodYearOverYear 6

type0 | 1 | 2 | 3 | 4

None: 0

Rocet: 1

Multivariate: 2

SegmentedMultivariate: 3

WeightedUnivariateRegression: 4

frequency0 | 1 | 2 | 4 | 12 | 52 | 365 | 1000

The frequency of the data.

Daily: 365

Weekly: 52

Monthly: 12

Quarterly: 4

SemiAnnual: 2

Annual: 1

cutOffPeriodsinteger

The target horizon of the model. Any forecasts after the cut off periods will be trimmed.

activeboolean

A flag to signal that the model is locked.

True: Model is locked and it should have a LockedModel associated with it.

False: Model is not locked and is editable in the application.

projectIdstring uuid

The UUID for the project the model is in.

usedAsIndicatorboolean

A flag to signal that an indicator has been created from the model.

analysisAsOfDatestring date-time

The As Of Date of the model. This is used to front trim the model's dependent variable to use less than the full data history to run a back test or by locked models to set their coefficients to a certain model period.

logPrimaryboolean

A flag which is used to determine if the primary dataset should be log(x + 1) transformed.

If this is true the calculation must be 'None'

True: Transform the points.

False: Does not transform the points.

activeLockedModelstring uuid nullable

The locked model Id.

tagsstring[] nullable

A list of tags that are assigned to the model.

urlstring nullable

The link to the model in the application.

parentTypestring nullable

The parent type of the model. Currently only parent type is a 'predict'

parentIdstring uuid

The UUID of the parent entity of the model.

parentUrlstring nullable

The URL to the model's parent entity.

notesstring nullable

User entered notes for the model.

modelStatestring nullable

The state of the model. Currently there are three possible options:

Draft

Archive

Production

manualboolean

If true, model output was manually entered.

modelForecastSummarystring nullable

For models in the Insights dashboard, an AI generated summary of the forecast.