---
title: "Join the waitlist for a sold-out pool offer, notified by email when it restocks"
method: POST
path: "/v1/numbers/waitlist"
---

# Join the waitlist for a sold-out pool offer, notified by email when it restocks

`POST /v1/numbers/waitlist`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/numbers/waitlist`
- Auth: HTTP bearer

Joins the waitlist for a sold-out offer (`POST /v1/numbers` failed with `pool_empty`) - it doesn't buy a number, just registers interest. You get an email once the offer restocks. An empty `{}` body uses the default offer (`praha`).

## Request body

- object
  - `offerId` string: Pool offer id to receive a restock email for. Omit for the default offer; joining an existing subscription is harmless.

## Response `200`

Joined

- object
  - `joined` true, required

## Other responses

- `400`: Error codes: validation (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `404`: Error codes: user_not_found (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)