---
title: Event logs
summary: <a href="https://www.fastly.com/documentation/guides/account-info/account-management/reviewing-service-activity-with-the-event-log/">Event logs</a> are used to audit actions performed by customers.
url: https://www.fastly.com/documentation/reference/api/account/events
---

<a href="https://www.fastly.com/documentation/guides/account-info/account-management/reviewing-service-activity-with-the-event-log/">Event logs</a> are used to audit actions performed by customers.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `admin` | boolean | Indicates if event was performed by Fastly. |
| `created_at` | string | Date and time in ISO 8601 format. (Read-only) |
| `customer_id` | string | Alphanumeric string identifying the customer. (Read-only) |
| `description` | string | Description of the event. |
| `event_type` | string | Type of event. Can be used with <code>filter[event_type]</code>. |
| `id` | string | Alphanumeric string identifying an event. (Read-only) |
| `ip` | string | IP addresses that the event was requested from. |
| `metadata` | object | Hash of key value pairs of additional information. |
| `service_id` | string | Alphanumeric string identifying the service. (Read-only) |
| `token_id` | string | Alphanumeric string identifying a token. (Read-only) |
| `type` | string | Resource type. (Read-only) |
| `user_id` | string | Alphanumeric string identifying the user. (Read-only) |

## API endpoints

### List events

**GET** `/events`

List all events for a particular customer. Events can be filtered by user, customer and event type. Events can be sorted by date.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `filter[created_at][gt]` | string | query | No | Return events after a date and time in ISO 8601 format. |
| `filter[created_at][gte]` | string | query | No | Return events on and after a date and time in ISO 8601 format. |
| `filter[created_at][lt]` | string | query | No | Return events before a date and time in ISO 8601 format. |
| `filter[created_at][lte]` | string | query | No | Return events on and before a date and time in ISO 8601 format. |
| `filter[created_at]` | string | query | No | Limit the returned events to a specific time frame. Accepts sub-parameters: lt, lte, gt, gte (e.g., filter[created_at][gt]=2022-01-12). |
| `filter[customer_id]` | string | query | No | Limit the results returned to a specific customer. |
| `filter[event_type]` | string | query | No | Limit the returned events to a specific <code>event_type</code>. |
| `filter[service_id]` | string | query | No | Limit the results returned to a specific service. |
| `filter[token_id]` | string | query | No | Limit the returned events to a specific token. |
| `filter[user_id]` | string | query | No | Limit the results returned to a specific user. |
| `page[number]` | integer | query | No | Current page. |
| `page[size]` | integer | query | No | Number of records per page. |
| `sort` | string | query | No | The order in which to list the results by creation date. |

### Get an event

**GET** `/events/{event_id}`

Get a specific event.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `event_id` | string | path | Yes | Alphanumeric string identifying an event. |