---
title: "List Event Subscriptions"
method: GET
path: "/eventSubscriptions"
tags: ["Event Subscriptions"]
---

# List Event Subscriptions

`GET /eventSubscriptions`

## Request

- Base URL: `https://eu-west-1.api.silverflow.com/v1`
- URL: `https://eu-west-1.api.silverflow.com/v1/eventSubscriptions`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/silverflow/apis/silverflow-api/docs/eventSubscriptions/get.ts> (a function with typed inputs; its response is checked against the schema)

This operation returns a paged list of all Event Subscriptions for the authenticated Agent.

Requires `eventSubscriptions:List` permission.

## Query parameters

- `sortOrder` 'asc' | 'desc'
- `limit` integer
- `offsetToken` string

## Response `200`

A paged list of Event Subscriptions

- EventSubscriptionsPage
  - `offsetToken` string
  - `moreItems` boolean
  - `eventSubscriptions` EventSubscription[], required
    - `key` string, required
    - `agentKey` string, required: Uniquely identifies an Agent
    - `status` 'active' | 'archived', required: The status of the Event Subscription
    - `description` string
    - `eventSource` string, required: A valid URL
    - `eventDataSchema` string, required: A valid URL
    - `targetUrl` string, required: A valid URL
    - `created` string, date-time, required: The date and time this object was created
    - `lastModified` string, date-time: The date and time this object was last modified
    - `version` integer, required: The version of this object

## Other responses

- `400`: The request was malformed. See the response body for details
- `401`: Authentication information is missing or invalid
- `403`: The authenticated client is forbidden to make the request for the resource identified.
- `429`: The number of requests (per minute) has exceeded the configured maximum

---

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