---
title: "List Events"
method: GET
path: "/event"
tags: ["event"]
---

# List Events

`GET /event`

## Request

- Base URL: `https://api-ch-gva-2.exoscale.com/v2`
- URL: `https://api-ch-gva-2.exoscale.com/v2/event`
- Auth: none declared
- TypeScript: <https://skmtc.dev/exoscale/apis/exoscale-api/docs/event/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve Mutation Events for a given date range. Defaults to retrieving Events for the past 24 hours.
         Both a `from` and `to` arguments can be specified to filter Events over a specific period.
         Events will be the the most descriptive possible but not all fields are mandatory

## Query parameters

- `from` string, date-time
- `to` string, date-time

## Response `200`

200

- Event[]
  - `iam-user` User: User
    - `sso` boolean: SSO enabled
    - `two-factor-authentication` boolean: Two Factor Authentication enabled
    - `email` string, required: User Email
    - `id` string, uuid: User ID
    - `role` IamRole, required: IAM Role
      - `description` string: IAM Role description
      - `labels` Labels
      - `permissions` string[]: IAM Role permissions
      - `assume-role-policy` IamAssumeRolePolicy: Assume Role Policy
        - `rules` IamServicePolicyRule[]: IAM Assume Role Policy rules
          - `action` 'allow' | 'deny'
          - `expression` string
          - `resources` string[]
      - `editable` boolean: IAM Role mutability
      - `name` string: IAM Role name
      - `max-session-ttl` integer: Maximum TTL requester is allowed to ask for when assuming a role
      - `policy` IamPolicy: Policy
        - `default-service-strategy` 'allow' | 'deny', required: IAM default service strategy
        - `services` object, required: IAM services
      - `id` string, uuid: IAM Role ID
    - `pending` boolean: True if the user has not yet created an Exoscale account
  - `request-id` string: Operation unique identifier
  - `iam-role` IamRole: IAM Role
    - `description` string: IAM Role description
    - `labels` Labels
    - `permissions` string[]: IAM Role permissions
    - `assume-role-policy` IamAssumeRolePolicy: Assume Role Policy
      - `rules` IamServicePolicyRule[]: IAM Assume Role Policy rules
        - `action` 'allow' | 'deny'
        - `expression` string
        - `resources` string[]
    - `editable` boolean: IAM Role mutability
    - `name` string: IAM Role name
    - `max-session-ttl` integer: Maximum TTL requester is allowed to ask for when assuming a role
    - `policy` IamPolicy: Policy
      - `default-service-strategy` 'allow' | 'deny', required: IAM default service strategy
      - `services` object, required: IAM services
    - `id` string, uuid: IAM Role ID
  - `zone` string: Operation targeted zone
  - `get-params` object: Query string parameters (free form map)
  - `body-params` object: Body parameters (free form map)
  - `status` integer: Operation HTTP status
  - `source-ip` string: Client IP address
  - `iam-api-key` IamApiKey: IAM API Key
    - `name` string: IAM API Key name
    - `key` string: IAM API Key
    - `role-id` string, uuid: IAM API Key Role ID
  - `uri` string: Operation request URI
  - `elapsed-ms` integer: Operation processing time
  - `timestamp` string, date-time: Time at which the event happened, millisecond resolution
  - `path-params` object: URI path parameters (free form map)
  - `handler` string: Operation handler name
  - `message` string: Operation message

## Changes

- **2026-11-06** `63da6f74c845`: 4 breaking, 2 info
  - removed the required property `items/iam-role/assume-role-policy/default-service-strategy` from the response with the `200` status
  - removed the required property `items/iam-role/assume-role-policy/services` from the response with the `200` status
  - removed the required property `items/iam-user/role/assume-role-policy/default-service-strategy` from the response with the `200` status
  - removed the required property `items/iam-user/role/assume-role-policy/services` from the response with the `200` status
  - …2 more
- **2026-03-16** `e05707a7b346`: 4 info
  - added the optional property `items/iam-role/assume-role-policy` to the response with the `200` status
  - added the optional property `items/iam-role/max-session-ttl` to the response with the `200` status
  - added the optional property `items/iam-user/role/assume-role-policy` to the response with the `200` status
  - added the optional property `items/iam-user/role/max-session-ttl` to the response with the `200` status
- **2025-05-22** `37a05010e8b4`: 2 warning
  - added the new `reset-iam-organization-policy` enum value to the `items/iam-role/permissions/items/` response property for the response status `200`
  - added the new `reset-iam-organization-policy` enum value to the `items/iam-user/role/permissions/items/` response property for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/exoscale/apis/exoscale-api/changes/event/get.md)

---

[API](https://skmtc.dev/exoscale/apis/exoscale-api.md) - [All operations](https://skmtc.dev/exoscale/apis/exoscale-api/llms.txt) - [OpenAPI document](https://skmtc.dev/exoscale/apis/exoscale-api/revisions/63da6f74c845?raw)