# Request word

`POST https://api.unique.domains/v1/words/{word}/request`

Brings a word into the catalog: checks it now and queues an accepted word for the intake.

Billed `Intake=1` only when the gate accepted the word (202 `accepted`, `Retry-After: 600`, poll the request); a word already in the catalog answers 200 `in_catalog`, a queued one 202 `queued` with its request id, a refused one 422 with the reason as `code` (`not_a_word`, `brand`, `offensive`), all billed `Intake=0`. 10 words a UTC day per consumer and 100 for the whole API, refused words included. When the gate cannot answer: 503 `gate_unavailable`, `Retry-After: 60`, never billed.

- Access: A member key (Founder or Investor) or a paid RapidAPI subscription to this API.
- Billing: One call, plus one word intake when the word is accepted.
- Plan: Investor plan. A Founder key answers 403 `plan_required`.
- Formats: JSON
- API: Word Intelligence API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `word` | string | Required | Path | One lowercase word of 2 to 63 letters a to z; no slug or id form. |

## Sample request

```bash
curl -X POST "https://api.unique.domains/v1/words/glimmerly/request" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `status` | string |  |
| `requestId` | string | On `accepted` and `queued`. |
| `poll` | string | `/v1/words/requests/<requestId>`; on `accepted`. |
| `word` | object | On `in_catalog`. |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`keyed_only`](https://unique.domains/api/problems/keyed_only) | 403 | A paid subscription is required |
| [`invalid_word`](https://unique.domains/api/problems/invalid_word) | 422 | Not a word the intake takes |
| [`disabled_in_catalog`](https://unique.domains/api/problems/disabled_in_catalog) | 422 | The word is disabled in the catalog |
| [`not_a_word`](https://unique.domains/api/problems/not_a_word) | 422 | Not a usable word |
| [`brand`](https://unique.domains/api/problems/brand) | 422 | A brand |
| [`offensive`](https://unique.domains/api/problems/offensive) | 422 | An offensive word |
| [`consumer_day_cap`](https://unique.domains/api/problems/consumer_day_cap) | 429 | Your intakes for today are spent |
| [`intake_day_cap`](https://unique.domains/api/problems/intake_day_cap) | 429 | Today's intakes are spent |
| [`rate_limited`](https://unique.domains/api/problems/rate_limited) | 429 | Too many requests |
| [`internal`](https://unique.domains/api/problems/internal) | 500 | Unexpected error |
| [`gate_unavailable`](https://unique.domains/api/problems/gate_unavailable) | 503 | The intake is unavailable |

## Example answer

200, application/json

```json
{
  "data": {
    "status": "accepted",
    "requestId": "6b0f6e3c-1d2a-4f6e-9a51-0c7d3b8e2f44",
    "poll": "/v1/words/requests/6b0f6e3c-1d2a-4f6e-9a51-0c7d3b8e2f44"
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/words/glimmerly/request",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

API status: https://uniquedomains.instatus.com

Full reference: https://unique.domains/api