---
title: "The calling user's zaps, received or sent"
method: GET
path: "/v1/me/zaps"
tags: ["Zaps"]
---

# The calling user's zaps, received or sent

`GET /v1/me/zaps`

## Request

- Base URL: `https://api.memestack.ai`
- URL: `https://api.memestack.ai/v1/me/zaps`
- Auth: HTTP bearer

Recorded zaps for the authenticated account — `received` (default) lists zaps on the caller's images with the payer as counterparty; `sent` lists the caller's own zaps with the recipient as counterparty. `total_received_sats` is the lifetime attested total received. Private, no-store.

## Query parameters

- `direction` 'received' | 'sent'
- `limit` integer
- `offset` integer

## Response `200`

Zap list.

- object
  - `zaps` object[]
    - `payment_hash` string
    - `image_id` string, uuid
    - `amount_sats` integer
    - `attested` boolean
    - `created_at` string, date-time
    - `counterparty_id` string, uuid: The payer on a `received` listing, the recipient on a `sent` one.
    - `counterparty_display_name` string, nullable
    - `counterparty_pubkey` string, nullable
    - `image_caption` string, nullable
  - `total_received_sats` integer

## Other responses

- `400`: `direction` is not `received` or `sent` (INVALID_DIRECTION).
- `401`: Authentication required.

---

[API](https://skmtc.dev/memestack/apis/memestack-api.md) · [All operations](https://skmtc.dev/memestack/apis/memestack-api/llms.txt) · [OpenAPI document](https://skmtc.dev/memestack/apis/memestack-api/revisions/9d3a19565f75?raw)