v1

latestOpenAPI 3.0.0Proprietary2026-07-244990150.4 KB

Psychic

Psychic Model Download

Downloads a Psychic model file. The request body selects the model (1, 2, 3, 4, m1, m2, m3, m4, model1, model2, model3, or model4). Models 1, 2, and 3 may set date to latest or a YYYY-MM-DD date. When date is omitted, the latest daily model is used. Models 1, 2, and 3 may also request an inclusive date range with start_date and end_date; ranges are limited to 30 days and return one combined download. Model 4 downloads the latest model 4 artifact. Model 4 may omit date or set date to latest, but does not support historical dates, start_date, or end_date. Set format to mmdb to download a MaxMind DB file. When format is omitted, the binary model format is used.

License: This endpoint requires the Psychic model meter entitlement for the requested model. Historical dates also require that model's Psychic lookback-days entitlement to cover the requested date or range start date.

post/v1/psychic

Request body

model'1' | '2' | '3' | '4' | 'm1' | 'm2' | 'm3' | 'm4' | 'model1' | 'model2' | 'model3' | 'model4' required

Psychic model selector. Accepted selectors identify models 1, 2, 3, and 4.

datestring

latest or a date in YYYY-MM-DD format. Future dates are rejected.

start_datestring

latest or a date in YYYY-MM-DD format. Future dates are rejected.

end_datestring

latest or a date in YYYY-MM-DD format. Future dates are rejected.

format'bin' | 'mmdb'

Download file format. Defaults to bin.

Example request

{
  "model": "model2",
  "date": "latest",
  "start_date": "latest",
  "end_date": "latest",
  "format": "bin"
}

Response

OK - binary Psychic model file.