---
title: "One card, whole"
method: GET
path: "/v1/cards/{id}"
tags: ["cards"]
---

# One card, whole

`GET /v1/cards/{id}`

## Request

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

A card out of reach is not found, exactly as one that doesn’t exist.

## Path parameters

- `id` string, required

## Headers

- `Pending-You-Version` '2026-10-05'
- `Pending-You-Client` string
- `DPoP` string
- `If-None-Match` string

## Response `200`

One card, whole

- CardResponse
  - `card` Card, required
    - `id` string, required
    - `version` integer, required
    - `status` union, required
      - 'pending' | 'delegated' | 'answered' | 'resolved' | 'snoozed' | 'expired' | 'cancelled'
      - string
    - `turn` 'you' | 'agent', required
    - `kind` union, required
      - 'choice' | 'multi' | 'approve' | 'text' | 'review' | 'action' | 'fyi' | 'group' | 'answer'
      - string
    - `intent` union
      - 'decide' | 'approve' | 'do' | 'tell' | 'heads_up'
      - string
    - `title` string, required
    - `summary` string, required
    - `summaryRuns` Run[]
      - union
        - union
          - object
            - `t` 'text', required
            - `text` string, required
            - `b` true
            - `i` true
            - `s` true
          - object
            - `t` 'code', required
            - `text` string, required
          - object
            - `t` 'br', required
          - object
            - `t` 'address', required
            - `text` string, required
          - object
            - `t` 'link', required
            - `href` string, uri, required
            - `words` string, required
            - `site` string, required
            - `asWritten` true
            - `own` object
              - …
            - `b` true
            - `i` true
            - `s` true
        - object
          - `t` string, required: A kind this version doesn’t know: /v1 adds kinds, so read past it (a doc has its `plain`).
    - `urgency` union, required
      - 'now' | 'today' | 'whenever'
      - string
    - `blocking` boolean, required
    - `fallback` object
      - `text` string, required
      - `at` string, date-time, required
    - `options` object[]
      - `id` string, required
      - `label` string, required
      - `detail` string
      - `consequence` string
      - `sends` object
        - `to` string, required
    - `recommendedIds` string[]
    - `rationale` string
    - `multi` object
      - `min` integer, required
      - `max` integer, required
    - `approve` object
      - `action` string, required
      - `command` string
      - `risk` union, required
        - 'low' | 'medium' | 'high'
        - string
      - `reversible` boolean, required
      - `because` union
        - 'spends' | 'irreversible' | 'public'
        - string
    - `text` object
      - `placeholder` string, required
      - `suggestions` string[]
      - `long` boolean
    - `action` object
      - `where` string
      - `steps` union[], required
        - union
          - string
          - object
            - `text` string, required
            - `command` string
      - `done` string
      - `command` string
      - `verify` string
    - `questions` object[]
      - `id` string, required
      - `kind` union, required
        - 'choice' | 'multi' | 'approve' | 'text'
        - string
      - `title` string, required
      - `detail` string
      - `options` object[]
        - `id` string, required
        - `label` string, required
        - `detail` string
        - `consequence` string
        - `sends` object
          - `to` string, required
      - `recommendedIds` string[]
      - `rationale` string
      - `multi` object
        - `min` number, required
        - `max` number, required
      - `approve` object
        - `action` string, required
        - `command` string
        - `risk` union, required
          - 'low' | 'medium' | 'high'
          - string
        - `reversible` boolean, required
        - `because` union
          - 'spends' | 'irreversible' | 'public'
          - string
      - `highStakes` boolean
      - `text` object
        - `placeholder` string, required
        - `suggestions` string[]
        - `long` boolean
    - `about` object
      - `kind` union, required
        - 'email' | 'pr' | 'booking' | 'document' | 'other'
        - string
      - `title` string, required
      - `ref` string
    - `threadId` string
    - `follows` string
    - `highStakes` boolean, required
    - `actions` union[], required
      - union
        - 'answer' | 'undo' | 'reply' | 'later' | 'back' | 'delegate' | 'take_back'
        - string
    - `area` object, required
      - `id` string, required
      - `name` string, required
    - `asker` object, required
      - `assistant` object, required
        - `id` string, required
        - `name` string, required
        - `app` union, required
          - 'claude-code' | 'codex' | 'cursor' | 'gemini-cli' | 'opencode' | 'pi' | 'grok' | 'muse' | 'chatgpt' | 'claude' | 'dots' | 'other' | 'webhook'
          - string
        - `appName` string, required
      - `agent` object
        - `id` string, required
        - `name` string, required
      - `task` object, required
        - `label` string, required
        - `cwd` string
        - `branch` string
      - `machine` object
        - `id` string
        - `name` string, required
    - `askedFirst` object
      - `where` union, required
        - 'terminal' | 'chat'
        - string
      - `at` string, date-time, required
      - `why` union
        - 'quiet' | 'away'
        - string
    - `answer` Answer
      - `answers` object
      - `choiceIds` string[]
      - `approved` boolean
      - `text` string
      - `note` object
        - `text` string, required
        - `via` union, required
          - 'voice' | 'text'
          - string
        - `audioSeconds` number
      - `theyDecide` boolean
      - `failedStep` integer
      - `handled` union
        - 'self' | 'leave'
        - string
      - `by` union
        - 'you' | 'go-between' | 'helper' | 'teammate'
        - string
      - `helper` object
        - `name` string, required
        - `why` string, required
        - `note` string
      - `where` union
        - 'app' | 'conversation'
        - string
      - `app` object
        - `id` string, required
        - `name` string, required
        - `machine` string
      - `answeredAt` string, date-time, required
    - `undoUntil` string, date-time
    - `snoozedUntil` string, date-time
    - `delegation` object
      - `to` object, required
        - `assistantId` string, required
        - `agentId` string
      - `mode` union, required
        - 'freely' | 'loop'
        - string
      - `state` union, required
        - 'working' | 'suggested' | 'answered' | 'returned' | 'taken_back'
        - string
      - `at` string, date-time, required
    - `ask` object
      - `id` string, required
      - `from` union, required
        - 'helper' | 'asker'
        - string
      - `name` string, required
      - `title` string, required
      - `summary` string
      - `options` object[]
        - `id` string, required
        - `label` string, required
        - `detail` string
        - `consequence` string
        - `sends` object
          - `to` string, required
      - `recommendedIds` string[]
      - `rationale` string
      - `highStakes` boolean, required
      - `at` string, date-time, required
      - `answered` object
        - `choiceIds` string[]
        - `text` string
        - `note` string
        - `answeredAt` string, date-time, required
    - `context` object
      - `background` string, required
      - `trace` object[], required
        - `state` union, required
          - 'done' | 'paused' | 'warn' | 'failed'
          - string
        - `text` string, required
      - `filesTouched` string[], required
      - `tried` string[], required
      - `links` object[], required
        - `label` string, required
        - `url` string, required
    - `backgroundDoc` Doc
      - `v` 1, required
      - `blocks` Block[], required
        - union
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - object
            - `t` string, required: A kind this version doesn’t know: /v1 adds kinds, so read past it (a doc has its `plain`).
      - `plain` string
    - `artifacts` union[]
      - union
        - object
          - `kind` union, required
            - 'image' | 'diff' | 'url' | 'file' | 'draft' | 'code'
            - string
          - `title` string, required
          - `ref` string, required
          - `attachmentId` string
          - `upload` boolean: image or file: true for an uploadUrl
          - `lines` string[]
          - `caption` string
          - `lang` union
            - 'ts' | 'json' | 'shell' | 'sql' | 'yaml' | 'toml' | 'css' | 'markdown' | 'text'
            - string
          - `startLine` integer
        - object
          - `kind` 'path', required
          - `title` string, required
          - `path` string, required
          - `machine` string
          - `bytes` integer
          - `modifiedAt` string, date-time
          - `note` string
          - `fetch` string
    - `asked` object
      - `text` string, required
      - `at` string, date-time
    - `body` Doc
      - `v` 1, required
      - `blocks` Block[], required
        - union
          - union
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
            - object
              - …
          - object
            - `t` string, required: A kind this version doesn’t know: /v1 adds kinds, so read past it (a doc has its `plain`).
      - `plain` string
    - `asOf` string, date-time
    - `dataSource` string
    - `dataSourceRuns` Run[]
      - union
        - union
          - object
            - `t` 'text', required
            - `text` string, required
            - `b` true
            - `i` true
            - `s` true
          - object
            - `t` 'code', required
            - `text` string, required
          - object
            - `t` 'br', required
          - object
            - `t` 'address', required
            - `text` string, required
          - object
            - `t` 'link', required
            - `href` string, uri, required
            - `words` string, required
            - `site` string, required
            - `asWritten` true
            - `own` object
              - …
            - `b` true
            - `i` true
            - `s` true
        - object
          - `t` string, required: A kind this version doesn’t know: /v1 adds kinds, so read past it (a doc has its `plain`).
    - `inChat` boolean
    - `attachments` Attachment[]
      - `id` string, required
      - `place` union, required
        - 'card' | 'message' | 'answer'
        - string
      - `title` string, required
      - `contentType` string
      - `bytes` integer
      - `width` integer
      - `height` integer
      - `downloadUrl` string, uri
      - `thumbUrl` string, uri
      - `previewUrl` string, uri
      - `downloadExpiresAt` string, date-time
    - `hasFiles` true
    - `thread` object[]
      - `id` string, required
      - `author` union, required
        - 'you' | 'agent' | 'pendingyou' | 'helper' | 'teammate'
        - string
      - `teammate` object
        - `name` string, required
      - `body` string, required
      - `via` union
        - 'voice' | 'text'
        - string
      - `audioSeconds` number
      - `attachmentIds` string[]
      - `app` object
        - `id` string, required
        - `name` string, required
        - `machine` string
      - `doc` Doc
        - `v` 1, required
        - `blocks` Block[], required
          - union
            - union
              - …
            - object
              - …
        - `plain` string
      - `createdAt` string, date-time, required
    - `threadCount` integer, required
    - `newReply` NewReply
      - `kind` union
        - 'report'
        - string
      - `at` string, date-time, required
      - `messageId` string, required
      - `preview` string, required
      - `answersYou` boolean, required
      - `asked` object
        - `text` string, required
        - `at` string, date-time, required
    - `partial` true
    - `presentation` Presentation
      - `v` 1, required
      - `layout` union, required
        - 'choice' | 'multi' | 'approve' | 'draft' | 'review' | 'todo' | 'text' | 'update' | 'group' | 'ask' | 'permission' | 'answer' | 'settled' | 'fallback'
        - string
      - `head` object, required
        - `intent` object
          - `kind` union, required
            - 'decide' | 'approve' | 'do' | 'tell' | 'heads_up'
            - string
          - `label` Line, required
            - `key` string, required
            - `args` object
            - `text` string, required
        - `wait` object
          - `line` Line, required
            - `key` string, required
            - `args` object
            - `text` string, required
          - `tone` union, required
            - 'you' | 'deadline' | 'quiet'
            - string
        - `marks` union[], required
          - union
            - 'files' | 'high_stakes'
            - string
      - `above` object[], required
        - `kind` union, required
          - 'asked_first' | 'helper' | 'note'
          - string
        - `title` Line
          - `key` string, required
          - `args` object
          - `text` string, required
        - `body` Line, required
          - `key` string, required
          - `args` object
          - `text` string, required
      - `options` object[]
        - `id` string, required
        - `suggested` Line
          - `key` string, required
          - `args` object
          - `text` string, required
      - `preselected` string[]
      - `below` Line[], required
        - `key` string, required
        - `args` object
        - `text` string, required
      - `box` object, required
        - `mode` union, required
          - 'hidden' | 'on_demand' | 'open'
          - string
        - `placeholder` Line
          - `key` string, required
          - `args` object
          - `text` string, required
      - `actions` PresentationAction[], required
        - `id` union, required
          - 'answer' | 'answer.option' | 'answer.approve' | 'answer.decline' | 'answer.done' | 'answer.got_it' | 'answer.allow' | 'answer.deny' | 'answer.send_words' | 'answer.send_changes' | 'answer.ask_keep_open' | 'didnt_work' | 'handle' | 'skip' | 'later' | 'back' | 'delegate' | 'take_back' | 'reply' | 'details' | 'undo' | 'open_web'
          - string
        - `label` Line, required
          - `key` string, required
          - `args` object
          - `text` string, required
        - `icon` union, required
          - 'send' | 'check' | 'x' | 'clock' | 'forward' | 'reply' | 'info' | 'undo' | 'back' | 'open' | 'hand'
          - string
        - `place` union, required
          - 'primary' | 'secondary' | 'link' | 'overflow' | 'dock'
          - string
        - `style` union, required
          - 'primary' | 'secondary' | 'quiet' | 'ghost' | 'danger'
          - string
        - `confirm` object
          - `kind` union, required
            - 'hold' | 'tap'
            - string
          - `prompt` Line, required
            - `key` string, required
            - `args` object
            - `text` string, required
          - `yes` Line, required
            - `key` string, required
            - `args` object
            - `text` string, required
          - `proof` union, required
            - 'none' | 'yes_key'
            - string
        - `sends` object
          - `approved` boolean
          - `choiceIds` string[]
          - `theyDecide` true
          - `handled` union
            - 'self' | 'leave'
            - string
        - `needs` union
          - 'choice' | 'words'
          - string
        - `disabledLabel` Line
          - `key` string, required
          - `args` object
          - `text` string, required
      - `settled` Line
        - `key` string, required
        - `args` object
        - `text` string, required
      - `row` object, required
        - `title` Line, required
          - `key` string, required
          - `args` object
          - `text` string, required
        - `meta` Line[], required
          - `key` string, required
          - `args` object
          - `text` string, required
      - `fallback` object, required
        - `line` Line, required
          - `key` string, required
          - `args` object
          - `text` string, required
        - `path` string, required
    - `url` string, uri, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `304`: Not modified: If-None-Match named this answer’s ETag.
- `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
- `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)