# Get agenda iCalendar

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

The whole public agenda as an iCalendar file.

One all-day event per dated public entry from today minus 30 days to plus 18 months (`month` is ignored), `text/calendar`, no envelope.

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

## Request

| Field | Type | Needs | Where | Description |
| --- | --- | --- | --- | --- |
| `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. |

## Sample request

```bash
curl -X GET "https://api.unique.domains/v1/agenda.ics?country=US&tld=bot"
```

## 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, text/calendar

```text
BEGIN:VCALENDAR
```

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

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