---
title: "List snapshots owned by the caller's wallet"
method: GET
path: "/api/snapshots"
tags: ["Snapshots"]
---

# List snapshots owned by the caller's wallet

`GET /api/snapshots`

## Request

- Base URL: `https://twitr.sh`
- URL: `https://twitr.sh/api/snapshots`
- Auth: API key in header `SIGN-IN-WITH-X`

Returns every extraction snapshot the caller's wallet has paid for. Wallet identity is proven via SIWX (Sign-In-With-X, CAIP-122). Pending snapshots are reconciled against the live job state on read.

## Response `200`

List of snapshots for the signing wallet.

- object
  - `wallet` string, required: Recovered signer address (lowercased).
  - `count` integer, required
  - `snapshots` object[], required
    - `snapshot_id` string, required
    - `actor_id` 'x_read' | 'x_search' | 'x_timeline' | 'x_lists' | 'x_communities' | 'x_extract' | 'x_monitor' | 'draws' | 'radar' | 'compose', required
    - `mode` string
    - `status` 'pending' | 'ready' | 'failed', required
    - `created_at` integer, required: Unix ms.
    - `record_count` integer: Only set when status=ready.
    - `paid_amount` string: USD decimal string.
    - `paid_protocol` 'x402' | 'mpp' | 'balance'

## Other responses

- `402`: Identity Required. Response advertises the `sign-in-with-x` extension; sign a CAIP-122 message with the user's wallet and retry with `SIGN-IN-WITH-X` header.

---

[API](https://skmtc.dev/twitr/apis/twitr-sh.md) · [All operations](https://skmtc.dev/twitr/apis/twitr-sh/llms.txt) · [OpenAPI document](https://skmtc.dev/twitr/apis/twitr-sh/revisions/f6390fcee344?raw)