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

# Psychic Snapshot Download

`POST /v1/psychic/snapshots`

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

## Request body

- PsychicSnapshotRequest — Snapshot downloads use precomputed artifacts only. Models 1, 2, and 3 require `days` with a value of `7` or `30`. Model 4 accepts `model` and optional `format` only; sending `days`, `date`, `start_date`, or `end_date` returns `400`.
  - `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.
  - `days` 7 | 30 — Required for models 1, 2, and 3. Must be omitted for model 4.
  - `format` 'bin' | 'mmdb' — Download file format. Defaults to `bin`.

## Response `200`

OK - binary Psychic snapshot 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)