---
title: "Check Handle"
method: POST
path: "/v1/handles/check"
tags: ["public"]
---

# Check Handle

`POST /v1/handles/check`

## Request

- Base URL: `https://www.tandem-cc.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.tandem-cc.com/v1/handles/check`
- Auth: none declared

Pre-flight: is `handle` valid and available, given this magic-link token?

The /setup page calls this as the user types. It does NOT consume the
token; that only happens on /reserve. The reservation must be live for
the call to go through — discourages using /check as a public handle-
existence oracle.

## Request body

- object

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/tandem-cc/apis/tandem-api.md) · [All operations](https://skmtc.dev/tandem-cc/apis/tandem-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tandem-cc/apis/tandem-api/revisions/3b804877b47c?raw)