# Get events iCalendar

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

The industry events as an iCalendar file.

One all-day event per dated industry event 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 | Optional | Query | An event category. |
| `country` | string | Optional | Query | ISO 3166-1 alpha-2; filters events only. |

## Sample request

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

## 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