# ListEvents Instance

Endpoint for listing events for a specific instance.

Endpoint: GET /api/instances/events
Version: 1.0
Security: x-api-key

## Query parameters:

  - `instanceID` (string)
    ID of an instance to filter by

  - `infrastructureID` (string)
    ID of an infrastructure to filter by

  - `infrastructureRevision` (integer)
    Revision of the infrastructure to filter by

  - `offset` (integer)
    Offset for pagination

  - `limit` (integer)
    Limit for pagination

  - `desc` (boolean)
    Order by descending order

  - `orgIdentifier` (string)
    Org is the organization identifier.

  - `projectIdentifier` (string)
    Project is the project identifier.

## Header parameters:

  - `Harness-Account` (string, required)
    Account is the internal customer account ID.

## Response 200 fields (application/json):

  - `events` (array)

  - `events.createdAt` (string)

  - `events.event` (object)

  - `events.event.state` (string, required)
    Enum: "unknown", "inactive", "instantiated", "running", "paused"

  - `events.id` (string)

  - `events.infrastructureId` (string)

  - `events.infrastructureRevision` (integer)

  - `events.instanceId` (string)

  - `total` (integer)

## Response 400 fields (application/json):

  - `code` (string)

  - `details` (object)

  - `message` (string, required)

  - `name` (string, required)