# Retrieve ANS agent events (https://developer.godaddy.com/en/docs/references/rest/ans/get-agent-events)

---
title: Retrieve ANS agent events
description: 'Returns a paginated, strictly ordered list of ANS events.'
full: true
---

Full description

Returns a paginated, strictly ordered list of ANS events. When providerId is omitted, the API returns events for all providers; when providerId is provided, only events associated with that provider are returned. Pagination is driven by an opaque cursor token returned in each response.

## GET /v1/agents/events

Retrieve ANS agent events

Returns a paginated, strictly ordered list of ANS events. When providerId is omitted, the API returns events for all providers; when providerId is provided, only events associated with that provider are returned. Pagination is driven by an opaque cursor token returned in each response.

### Query parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `providerId` | string | no | Optional provider identifier. If omitted, global mode is used and the API returns events for all providers from the primary global stream. When provided, results are filtered to only events associated with that provider. |
| `lastLogId` | string | no | Optional log id for the last viewed event from a previous request. If not provided, the API returns the first page of results from the start of the event stream. Events are only stored for 30 days. |
| `limit` | integer | no | Number of events to return (1-200, default 100) |

### Header parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `X-Request-Id` | string | no | Unique identifier for request tracking between services (UUID V1 as Base58) |

### Responses

**200** — Successful operation

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/EventPageResponse`

**400** — Malformed request syntax (invalid JSON, encoding issues)

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**401** — Authentication failed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**403** — Authorization failed

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**422** — Invalid request parameters (invalid cursor, out-of-range limit, invalid providerId)

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**429** — Too many requests - throttled

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`

**500** — Internal server error

Content-Type: `application/json`

Schema:

- schema reference: `#/components/schemas/ErrorResponse`