---
title: "Say the person opened a card"
method: POST
path: "/v1/cards/{id}/seen"
tags: ["cards"]
---

# Say the person opened a card

`POST /v1/cards/{id}/seen`

## Request

- Base URL: `https://www.pendingyou.com`
- URL: `https://www.pendingyou.com/v1/cards/{id}/seen`
- Auth: OAuth 2 (authorization code, authorization URL `https://www.pendingyou.com/oauth/authorize`, token URL `https://www.pendingyou.com/oauth/token`, scopes: `cards:manage`)

Its new reply is seen, on every device: the card leaves Pending and loses its mark in Done. `seen: false` when there was nothing new for them on it. Pending You’s own apps only, for now (cards:manage).

## Path parameters

- `id` string, required

## Headers

- `Pending-You-Version` '2026-10-05'
- `Pending-You-Client` string
- `DPoP` string
- `Idempotency-Key` string

## Request body

- SeenRequest

## Response `200`

Say the person opened a card

- SeenResponse
  - `id` string, required
  - `seen` boolean, required

## Other responses

- `400`: invalid
- `401`: invalid_token, invalid_dpop_proof or use_dpop_nonce (OAuth, with WWW-Authenticate)
- `403`: app_not_available; insufficient_scope (OAuth, with WWW-Authenticate naming the scope)
- `404`: not_found
- `409`: idempotency_in_progress
- `422`: idempotency_mismatch
- `426`: client_outdated
- `429`: rate_limited
- `500`: server_error
- `503`: unavailable

---

[API](https://skmtc.dev/pendingyou/apis/pending-you-person-api.md) · [All operations](https://skmtc.dev/pendingyou/apis/pending-you-person-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pendingyou/apis/pending-you-person-api/revisions/4c0d997495a6?raw)