---
title: "Who and what this sign-in is"
method: GET
path: "/v1/me"
tags: ["me"]
---

# Who and what this sign-in is

`GET /v1/me`

## Request

- Base URL: `https://www.pendingyou.com`
- URL: `https://www.pendingyou.com/v1/me`
- Auth: OAuth 2 (authorization code, authorization URL `https://www.pendingyou.com/oauth/authorize`, token URL `https://www.pendingyou.com/oauth/token`)

The person, their workspace, the app and this sign-in: its scopes, its reach (one computer or every card), its computer, and when it ends. Any scope.

## Headers

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

## Response `200`

Who and what this sign-in is

- Me
  - `user` object, required
    - `id` string, required
  - `workspace` object, required
    - `id` string, required
  - `app` object, required
    - `id` string, required
    - `name` string, required
    - `verified` boolean, required
  - `grant` object, required
    - `id` string, required
    - `scopes` union[], required
      - union
        - 'cards:read' | 'cards:read:all' | 'cards:answer' | 'cards:reply' | 'cards:later' | 'cards:delegate' | 'assistants:read' | 'presence:desk' | 'cards:high_stakes' | 'cards:manage' | 'account:manage'
        - string
    - `reach` union, required
      - 'machine' | 'all'
      - string
    - `machine` object
      - `id` string, required
      - `name` string, required
    - `dpop` boolean, required
    - `createdAt` string, date-time, required
    - `expiresAt` string, date-time, required
    - `yesKey` object
      - `registeredAt` 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)
- `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)