---
title: "Check Handle"
method: GET
path: "/founding/handle-check"
tags: ["founding"]
---

# Check Handle

`GET /founding/handle-check`

Live availability for the name picker: companies UNION open foundings.

Excludes the caller's own open interview, so re-checking the handle you
already reserved reads ``available`` rather than ``reserved``.

## Query parameters

- `h` string, required

## Response `200`

Successful Response

- HandleCheckResponse — ``available`` | ``taken`` | ``reserved`` | ``invalid``, plus a suggestion. ``reserved`` is a handle another founder is mid-interview on. Distinct from ``taken`` because it is temporary — that interview can be abandoned — and the copy should not imply the name is gone forever.
  - `handle` string, required
  - `status` string, required
  - `address` string, nullable
  - `suggestion` string, nullable
  - `message` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/nanocorp/apis/nanocorp-api.md) · [All operations](https://skmtc.dev/nanocorp/apis/nanocorp-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nanocorp/nanocorp-api/revisions/04b208d3215b/schema)