v1

latestOpenAPI 3.0.0Proprietary2026-07-244990150.4 KB

Psychic

Psychic Snapshot Download

Downloads a precomputed Psychic snapshot artifact. Snapshots are fixed, already-materialized files for common rolling windows and latest model 4. This endpoint does not generate missing ranges or convert missing MMDBs.

Models 1, 2, and 3 require days and currently support only 7 or 30. Model 4 downloads the latest model 4 snapshot and rejects days. date, start_date, and end_date are not supported on this endpoint.

A successful response streams the snapshot file. Transfer time still depends on file size and client connection speed. A 404 response means the requested snapshot artifact is not available.

License: This endpoint requires the Psychic model meter entitlement for the requested model. Models 1, 2, and 3 also require that model's Psychic lookback-days entitlement to cover the resolved snapshot start date.

post/v1/psychic/snapshots

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.

days7 | 30

Required for models 1, 2, and 3. Must be omitted for model 4.

format'bin' | 'mmdb'

Download file format. Defaults to bin.

Example request

{
  "model": "model2",
  "days": 30,
  "format": "bin"
}

Response

OK - binary Psychic snapshot file.