---
title: "Record a recipient visit and obtain a signed attribution receipt"
method: POST
path: "/api/shares/{token}/visit"
---

# Record a recipient visit and obtain a signed attribution receipt

`POST /api/shares/{token}/visit`

## Request

- Base URL: `https://api.peelaway.io`
- URL: `https://api.peelaway.io/api/shares/{token}/visit`
- Auth: one of:
  - none
  - API key in cookie `better-auth.session_token`

Called after a visible recipient page and analytics consent, or for an explicit vote/remix action. Known owner visits return a null receipt. The receipt contains an opaque visit identifier, not the bearer share token. Reuse a UUID visitId for retries.

## Path parameters

- `token` string, required

## Request body

- object
  - `visitId` string, uuid, required

## Response `200`

receipt (nullable), shareId, visitId and source surface

## Other responses

- `400`: Invalid or already claimed visit
- `429`: Rate limited

---

[API](https://skmtc.dev/peelaway/apis/peelaway-image-api.md) · [All operations](https://skmtc.dev/peelaway/apis/peelaway-image-api/llms.txt) · [OpenAPI document](https://skmtc.dev/peelaway/apis/peelaway-image-api/revisions/8ce45533c9d0?raw)