# List events

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

The industry events of one month, in date order, then the events still without a date.

Conferences and meetups of the domain industry, served whole for the month (no cursor). Open one with `GET /events/{slug}` for its organizer, location and description.

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

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `month` | string | Optional | Query | `YYYY-MM`, from the month of today minus 30 days to today plus 18 months; the current month by default. |
| `category` | string: domaining, dns_governance, brand_ip, hosting_cloud, security_privacy, other_tech | Optional | Query | An event category. |
| `country` | string | Optional | Query | ISO 3166-1 alpha-2; filters events only. |
| `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/events?month=2026-11&country=US"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `id` | string |  |
| `slug` | string |  |
| `title` | string |  |
| `startsOn` | string \| null |  |
| `endsOn` | string \| null | Inclusive last day; null for one day. |
| `category` | string \| null |  |
| `countryCode` | string \| null |  |
| `city` | string \| null |  |
| `lat` | number \| null |  |
| `lng` | number \| null |  |
| `kind` | string |  |

## 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": [
    {
      "id": "0d6a3b52-7e1f-4c2b-9b8e-5a1f2c3d4e5f",
      "slug": "namescon-global-2026",
      "title": "NamesCon Global",
      "startsOn": "2026-11-17",
      "endsOn": "2026-11-19",
      "category": "domaining",
      "countryCode": "US",
      "city": "Austin",
      "lat": 30.27,
      "lng": -97.74,
      "kind": "industry_event"
    }
  ],
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/events?month=2026-11&country=US",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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