---
title: "Create a seven-day frozen civic export"
method: POST
path: "/api/v1/data/snapshots"
tags: ["Customer civic data"]
---

# Create a seven-day frozen civic export

`POST /api/v1/data/snapshots`

## Request

- Base URL: `https://aicdapi.com`
- URL: `https://aicdapi.com/api/v1/data/snapshots`
- Auth: HTTP bearer

Charges one export request plus normal request and burst allowances. Complete every resource, including aliases, then consume changes from boundaryCursor. A snapshot and its boundary represent one consistent database state.

## Response `201`

Snapshot created.

- object
  - `data` object, required
    - `snapshotId` string, uuid, required
    - `boundaryCursor` string, required: Opaque continuation token. Store and replay without modification.
    - `createdAt` string, date-time, required: UTC timestamp ending in Z.
    - `expiresAt` string, date-time, required: UTC timestamp ending in Z.
    - `counts` object, required

## Other responses

- `400`: Invalid parameter, duplicate query field or malformed JSON.
- `401`: Missing, invalid, expired or revoked credential.
- `403`: Customer lacks the required grant.
- `404`: Snapshot does not exist, belongs to another customer, or expired.
- `410`: Cursor is older than the retained replay floor; start a new snapshot.
- `413`: Request or response exceeds its size cap; reduce the page limit.
- `429`: A per-account request, burst or export allowance was exhausted, or the account-wide abuse ceiling was reached. The abuse ceiling is account-wide, is not charged against the paid quota, and is charged after the identity lookup and before a revoked, expired, unpaid, or scope-denied rejection is decided.
- `500`: Unexpected operation failure; the response contains no private database details.
- `503`: Authentication, limit store or feed state is unavailable.
- `504`: Database statement or request deadline exceeded.

---

[API](https://skmtc.dev/aicdapi/apis/aicd-api.md) · [All operations](https://skmtc.dev/aicdapi/apis/aicd-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aicdapi/apis/aicd-api/revisions/0f3752fae465?raw)