# Get agenda

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

The whole public agenda of one month: industry events, TLD launch phases and registry changes.

The dated entries overlapping the month in date order, the registry announcements of the last 30 days without a day of their own (newest first), and the events without a date. Served whole (no cursor).

- 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, launches | Optional | Query | An event category, or `launches` for the TLD entries. |
| `country` | string | Optional | Query | ISO 3166-1 alpha-2; filters events only. |
| `tld` | string | Optional | Query | A bare root ending the catalog knows. |
| `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/agenda?month=2026-11&country=US&tld=bot"
```

## Response

| Field | Type | Description |
| --- | --- | --- |
| `entries` | object[] |  |
| `recentlyAdded` | object[] |  |
| `undated` | 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": {
    "entries": [
      {
        "id": "8c4e2f10-3b6a-4d7e-a1f9-6e2b5c8d0a37",
        "kind": "tld_phase",
        "title": ".bot general availability",
        "startsOn": "2026-11-12",
        "endsOn": null,
        "category": "launches",
        "countryCode": null,
        "city": null,
        "lat": null,
        "lng": null,
        "tld": "bot"
      }
    ],
    "recentlyAdded": [],
    "undated": []
  },
  "meta": {
    "asOf": "2026-11-05T08:00:00Z",
    "cursor": null,
    "limit": null
  },
  "links": {
    "self": "https://api.unique.domains/v1/agenda?month=2026-11&country=US&tld=bot",
    "next": null,
    "register": null,
    "product": null,
    "dataset": null
  }
}
```

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

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