---
title: "What this app should know of Pending You"
method: GET
path: "/v1/client"
tags: ["client"]
---

# What this app should know of Pending You

`GET /v1/client`

## Request

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

For Pending You’s own apps, which say who they are in `Pending-You-Client` (`ios/1.4.0+120`): whether this version must update (`status`, `minimum`, `recommended`), its switches, and the versions of the string catalog and of cards’ presentation. Any scope, or no sign-in at all; signed in, switches that reach some people are read for the person.

## Headers

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

## Response `200`

What this app should know of Pending You

- ClientConfig
  - `client` object
    - `name` union, required
      - 'ios' | 'web'
      - string
    - `version` string, required
    - `build` integer
  - `status` union, required
    - 'ok' | 'update_recommended' | 'update_required'
    - string
  - `minimum` string
  - `recommended` string
  - `switches` object, required
  - `catalog` object, required
    - `version` string, required
  - `presentation` object, required
    - `v` integer, 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)