# Batch names

`POST https://api.unique.domains/v1/names/batch`

The keyed name resource for up to 100 names in one call.

One entry per name, in the request's order: the keyed `GET /names/{name}` resource, `{ name, tracked: false }` for a name the catalog never stored, or `{ name, error: "validation_failed" }` for an entry that is not a name. No live read. Billed one request per name sent, refused entries included.

- 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: Domain Check API

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `fields` | string | Optional | Query | Comma-separated top-level keys to keep; an unknown key answers 400 `unsupported_field`. |
| `names` | string[] | Required | Body | 1 to 100 names. |

## Sample request

```bash
curl -X POST "https://api.unique.domains/v1/names/batch" \
  -H "Authorization: Bearer YOUR_MEMBER_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "names": [
      "get.plumbing",
      "zorbly.ai",
      "foo@bar.com"
    ]
  }'
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `id` | string \| null | `dom_<uuid>`; null when `tracked` is false. |
| `name` | string |  |
| `ending` | string |  |
| `tracked` | boolean | The catalog stores the name. |
| `status` | string | Where the name stands for a buyer. A list row's stored status reads here as: `resell` is `for_sale` (`at_auction` at a drop-catch venue), `premium` is `free_premium`. |
| `lifecycle` | string \| null |  |
| `drop` | object |  |
| `ownableNow` | boolean |  |
| `price` | object |  |
| `registry` | object |  |
| `parking` | string \| null | The parking or sale venue id. |
| `length` | integer \| null |  |
| `format` | string \| null |  |
| `shape` | string \| null |  |
| `word` | object \| null |  |
| `rating` | object |  |
| `verdict` | object \| null | Keyed. |
| `value` | object \| null | Keyed. |
| `comps` | object |  |

## 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 |
| [`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": [
    {
      "id": "dom_4efccac7-d9df-4c96-a076-3e0cc64220ec",
      "name": "get.plumbing",
      "ending": "plumbing",
      "tracked": true,
      "status": "for_sale",
      "lifecycle": "active",
      "drop": {
        "kind": "none"
      },
      "ownableNow": false,
      "price": {
        "kind": "aftermarket",
        "firstYear": null,
        "registrar": null,
        "renewal": null,
        "transfer": null,
        "isPromo": null,
        "renewalTrap": false,
        "regularPrice": null
      },
      "registry": {
        "createdAt": "2020-06-03T08:30:53.000Z",
        "updatedAt": "2026-08-12T04:41:40.000Z",
        "expiresAt": "2027-06-03T08:30:53.000Z",
        "registryUpdatedAt": "2026-10-22T13:39:28.000Z",
        "registrar": {
          "name": "GoDaddy.com, LLC",
          "ianaId": 146,
          "url": null
        }
      },
      "parking": "afternic",
      "length": 3,
      "format": null,
      "shape": "single",
      "word": {
        "id": "wrd_23922",
        "word": "get",
        "slug": "get"
      },
      "rating": {
        "band": "prime"
      },
      "comps": {
        "tier": "same_word",
        "count": 10,
        "medianUsd": 2677,
        "endingsSoldOn": 0
      },
      "verdict": {
        "rating": "good",
        "confidence": "medium"
      },
      "value": {
        "value": 4200,
        "upsidePercent": null,
        "liquidity": "medium"
      }
    },
    {
      "name": "zorbly.ai",
      "tracked": false
    },
    {
      "name": "foo@bar.com",
      "error": "validation_failed"
    }
  ],
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/names/batch",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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