---
title: "Psychic Model Download"
method: POST
path: "/v1/psychic"
tags: ["Psychic"]
---

# Psychic Model Download

`POST /v1/psychic`

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._

## Request body

- PsychicDownloadRequest
  - `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.
  - `date` string — `latest` or a date in `YYYY-MM-DD` format. Future dates are rejected.
  - `start_date` string — `latest` or a date in `YYYY-MM-DD` format. Future dates are rejected.
  - `end_date` string — `latest` or a date in `YYYY-MM-DD` format. Future dates are rejected.
  - `format` 'bin' | 'mmdb' — Download file format. Defaults to `bin`.

## Response `200`

OK - binary Psychic model file.

## Other responses

- `400` — Bad request - request syntax is invalid for the Psychic download endpoint.
- `401` — Unauthorized. Please check your API key.
- `403` — Forbidden - request is not authorized due to API-key access, Psychic entitlement, or Psychic lookback limitations.
- `404` — Psychic model file not found.
- `413` — Request body too large. BI request-body inspection is limited to 32 KiB.
- `429` — Too many requests - either too many concurrent Psychic range downloads are being generated, or the requested Psychic model meter has no remaining usage. Retry later for concurrent-generation limits, or contact sales@greynoise.io to adjust model usage entitlements.
- `500` — Unexpected Psychic download error.

---

[API](https://skmtc.dev/greynoise/apis/greynoise-api.md) · [All operations](https://skmtc.dev/greynoise/apis/greynoise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greynoise/greynoise-api/revisions/30942574656d/schema)