# The domain's timeline

> The domain's timeline: reference page for this CustomDomain™ API operation in the connections group. Covers parameters, request body, responses and error codes.

Source: https://docs.customdomain.ai/docs/api-reference/connections/listConnectionEvents

## `GET https://api.customdomain.ai/v1/connections/{id}/events`

What happened to the domain, newest first: certificates issued, renewed, failing and expiring; drift found and what was done about it; access kept and revoked. `kind` narrows it to a prefix (`certificate.`, `drift.`, `access.`); `before` pages back with the previous page's `next_before`. An end user's widget token (scope `connect`) reads this only when it is bound to the domain and minted with the connection's own `end_user_ref`; use an API key otherwise.

### Authentication

`widgetJWT`, `apiKey`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | string | yes |  |
| `kind` | query | string | no |  |
| `before` | query | string | no |  |
| `limit` | query | integer | no |  |

### Responses

| Status | Description |
| --- | --- |
| `200` | The events |
| `400` | Error envelope: {code, title, details}. |
| `401` | Error envelope: {code, title, details}. |
| `404` | Error envelope: {code, title, details}. |

### `200` response body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `connection_id` | string | yes |  |
| `domain` | string | yes |  |
| `events` | array of object | yes |  |
| `next_before` | string | no |  |

The full specification is served at `GET https://api.customdomain.ai/v1/openapi.json`.
