# Get domain drops

`GET https://api.unique.domains/v1/domains/drops`

Names dropping on one day: counts free, names keyed.

Names in pending delete with a verified drop day. Free: the count, the split by ending and the ending and day of five names, never a name. Keyed (Investor plan): the names, by name. `day` runs from today (UTC) to today plus 6.

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

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `day` | string | Optional | Query | The drop day, UTC; default today. |
| `ending` | string | Paid | Query | Comma list of endings without the dot. |
| `limit` | integer | Optional | Query | Rows a page: 20 by default, at most 20 without a key and 100 with a paid subscription; a larger value is clamped. |
| `cursor` | string | Paid | Query | The `meta.cursor` of the previous page; the last page answers `null`. |
| `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/domains/drops"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `count` | integer |  |
| `byEnding` | object[] |  |
| `sample` | object[] |  |

## Errors

| Code | Status | What it means |
| --- | --- | --- |
| [`validation_failed`](https://unique.domains/api/problems/validation_failed) | 400 | A value is not valid |
| [`cursor_invalid`](https://unique.domains/api/problems/cursor_invalid) | 400 | The cursor is not valid |
| [`keyed_only`](https://unique.domains/api/problems/keyed_only) | 403 | A paid subscription is required |
| [`plan_required`](https://unique.domains/api/problems/plan_required) | 403 | The Investor plan 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": {
    "count": 184,
    "byEnding": [
      {
        "ending": "online",
        "count": 151
      },
      {
        "ending": "site",
        "count": 19
      },
      {
        "ending": "xyz",
        "count": 14
      }
    ],
    "sample": [
      {
        "ending": "online",
        "dropsOn": "2026-11-07"
      },
      {
        "ending": "xyz",
        "dropsOn": "2026-11-07"
      },
      {
        "ending": "online",
        "dropsOn": "2026-11-07"
      },
      {
        "ending": "site",
        "dropsOn": "2026-11-07"
      },
      {
        "ending": "online",
        "dropsOn": "2026-11-07"
      }
    ]
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": 20
  },
  "links": {
    "self": "https://api.unique.domains/v1/domains/drops",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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