# Get meta enums

`GET https://api.unique.domains/v1/meta/enums`

Every enum the payloads use, read from the code catalogs.

Name statuses, registry lifecycles and EPP statuses, lookup states, word shapes and origins, TLD kinds, agenda and event categories, edition lanes, the change types and subjects, the auction venues and the parking services. An auction answer carries its own venue id and label on each row, which may name a venue this list leaves out.

- Access: No key. Limited per address; a key adds the paid fields.
- Billing: One call.
- Formats: JSON

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `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/meta/enums"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `statuses` | string[] |  |
| `lifecycles` | string[] |  |
| `eppStatuses` | string[] |  |
| `lookupStates` | string[] |  |
| `wordShapes` | string[] |  |
| `wordOrigins` | string[] |  |
| `tldKinds` | string[] |  |
| `agendaCategories` | string[] |  |
| `eventCategories` | string[] |  |
| `editionLanes` | string[] |  |
| `changeEventTypes` | string[] |  |
| `changeEventSubjects` | string[] |  |
| `auctionVenues` | object[] |  |
| `parkingServices` | object[] |  |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`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": {
    "statuses": [
      "available",
      "premium",
      "resell",
      "expiring",
      "expired",
      "taken",
      "dormant",
      "sold",
      "unknown"
    ],
    "wordOrigins": [
      "dictionary",
      "trend",
      "api",
      "review"
    ],
    "auctionVenues": [
      {
        "id": "godaddy",
        "label": "GoDaddy"
      }
    ]
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/meta/enums",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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