# Get word request

`GET https://api.unique.domains/v1/words/requests/{requestId}`

The state of a word request: queued, ready with its catalog word, refused or failed.

Reads the request by its id. `queued` while the intake has not finished; `ready` names the catalog word and whether its first scan of every ending ran; `rejected` the reason code. Not metered.

- Access: A member key (Founder or Investor) or a paid RapidAPI subscription to this API.
- Billing: One call.
- Plan: Investor plan. A Founder key answers 403 `plan_required`.
- Formats: JSON
- API: Word Intelligence API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `requestId` | string | Required | Path | The id the request answered. |
| `fields` | string | Optional | Query | Comma-separated top-level keys to keep; an unknown key answers 400 `unsupported_field`. |

## Sample request

```bash
curl -X GET "https://api.unique.domains/v1/words/requests/6b0f6e3c-1d2a-4f6e-9a51-0c7d3b8e2f44" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `requestId` | string |  |
| `status` | string |  |
| `word` | object \| null | On `ready`; null when the catalog no longer serves the word. |
| `scan` | string | On `ready` with a word: whether the first scan of every ending ran. |
| `reason` | string | On `rejected`. |
| `requestedAt` | string |  |
| `resolvedAt` | string \| null | Null while queued. |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`validation_failed`](https://unique.domains/api/problems/validation_failed) | 400 | A value is not valid |
| [`keyed_only`](https://unique.domains/api/problems/keyed_only) | 403 | A paid subscription is required |
| [`not_found`](https://unique.domains/api/problems/not_found) | 404 | Not found |
| [`rate_limited`](https://unique.domains/api/problems/rate_limited) | 429 | Too many requests |
| [`internal`](https://unique.domains/api/problems/internal) | 500 | Unexpected error |

## Example answer

200, application/json

```json
{
  "data": {
    "requestId": "6b0f6e3c-1d2a-4f6e-9a51-0c7d3b8e2f44",
    "status": "ready",
    "word": {
      "id": "wrd_565120",
      "slug": "glimmerly"
    },
    "scan": "pending",
    "requestedAt": "2026-11-05T09:14:02.000Z",
    "resolvedAt": "2026-11-05T09:20:11.000Z"
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/words/requests/6b0f6e3c-1d2a-4f6e-9a51-0c7d3b8e2f44",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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