# List active triggers

**Documentation:** /reference/api-reference/triggers/getTriggerInstancesActive

Retrieves all active trigger instances for your project. Triggers listen for events from connected accounts (e.g., new emails, Slack messages, GitHub commits) and can invoke webhooks or workflows. Use filters to find triggers for specific users, connected accounts, or trigger types.

---

## GET `/api/v3/trigger_instances/active`

**Endpoint:** `https://backend.composio.dev/api/v3/trigger_instances/active`

**Summary:** List active triggers

Retrieves all active trigger instances for your project. Triggers listen for events from connected accounts (e.g., new emails, Slack messages, GitHub commits) and can invoke webhooks or workflows. Use filters to find triggers for specific users, connected accounts, or trigger types.

### Authentication

**ApiKeyAuth** - API Key in `header` header `x-api-key` OR **UserApiKeyAuth** - API Key in `header` header `x-user-api-key`

### Query Parameters

- `user_ids` (array,null): Array of user IDs to filter triggers by
- `connected_account_ids` (array,null): Array of connected account IDs to filter triggers by
- `auth_config_ids` (array,null): Array of auth config IDs to filter triggers by
- `trigger_ids` (array,null): Array of trigger IDs to filter triggers by
- `trigger_names` (array,null): Array of trigger names to filter triggers by. Case-insensitive (internally normalized to uppercase).
- `connectedAccountIds` (array,null): DEPRECATED: This parameter will be removed in a future version. Please use connected_account_ids instead.
- `authConfigIds` (array,null): DEPRECATED: This parameter will be removed in a future version. Please use auth_config_ids instead.
- `triggerIds` (array,null): DEPRECATED: This parameter will be removed in a future version. Please use trigger_ids instead.
- `show_disabled` (boolean,null): When set to true, includes disabled triggers in the response.
- `triggerNames` (array,null): DEPRECATED: This parameter will be removed in a future version. Please use trigger_names instead.
- `showDisabled` (boolean,null): DEPRECATED: This parameter will be removed in a future version. Please use show_disabled instead.
- `deprecatedConnectedAccountUuids` (array,null): DEPRECATED: This parameter will be removed in a future version. Please use connected_account_ids instead.
- `deprecatedAuthConfigUuids` (array,null): DEPRECATED: This parameter will be removed in a future version. Please use auth_config_ids instead.
- `limit` (number,null): Number of items per page, max allowed is 1000
- `cursor` (string): Cursor for pagination. The cursor is a base64 encoded string of the page and limit. The page is the page number and the limit is the number of items per page. The cursor is used to paginate through the items. The cursor is not required for the first page.

### Responses

#### 200 - Successfully retrieved active trigger instances

**Response Schema:**

- `items` (array<object>) *(required)*
  - Array items:
    - `uuid` (string): Unique identifier of the trigger instance
    - `id` (string (triggerInstanceId)) *(required)*: Nano ID of the trigger instance
    - `connected_account_id` (string) *(required)*: ID of the connected account this trigger is associated with
    - `trigger_name` (string) *(required)*: Name of the trigger
    - `connected_account_uuid` (string) *(required)*: UUID of the connected account this trigger is associated with
    - `user_id` (string) *(required)*: ID of the user this trigger is associated with
    - `trigger_data` (string): Additional data associated with the trigger instance
    - `version` (string) *(required)*: Version of the trigger instance
    - `trigger_config` (object) *(required)*: Configuration for the trigger
      - `[key: string]` (any)
    - `state` (object) *(required)*: State of the trigger instance
      - `[key: string]` (any)
    - `updated_at` (string) *(required)*: ISO 8601 timestamp when the trigger instance was updated
    - `disabled_at` (string,null) *(required)*: ISO 8601 timestamp when the trigger instance was disabled, if applicable
    - `disabledAt` (string,null) *(required)*: DEPRECATED: This parameter will be removed in a future version. Please use disabled_at instead.
    - `connectedAccountId` (string) *(required)*: DEPRECATED: This parameter will be removed in a future version. Please use connected_account_id instead.
    - `triggerName` (string) *(required)*: DEPRECATED: This parameter will be removed in a future version. Please use trigger_name instead.
    - `updatedAt` (string) *(required)*: DEPRECATED: This parameter will be removed in a future version. Please use updated_at instead.
    - `triggerConfig` (object) *(required)*: DEPRECATED: This parameter will be removed in a future version. Please use trigger_config instead.
      - `[key: string]` (any)
    - `deprecated` (object): Deprecated fields for the trigger instance
      - `createdAt` (string) *(required)*: Deprecated created_at for the trigger instance
- `next_cursor` (string,null)
- `total_pages` (number) *(required)*
- `current_page` (number) *(required)*
- `total_items` (number) *(required)*

**Example Response:**

```json
{
  "items": [
    {
      "uuid": "string",
      "id": "string",
      "connected_account_id": "string",
      "trigger_name": "string",
      "connected_account_uuid": "string",
      "user_id": "string",
      "trigger_data": "string",
      "version": "string",
      "trigger_config": {
        "key": "..."
      },
      "state": {
        "key": "..."
      },
      "updated_at": "string",
      "disabled_at": null,
      "disabledAt": null,
      "connectedAccountId": "string",
      "triggerName": "string",
      "updatedAt": "string",
      "triggerConfig": {
        "key": "..."
      },
      "deprecated": {
        "createdAt": "..."
      }
    }
  ],
  "next_cursor": null,
  "total_pages": 1,
  "current_page": 1,
  "total_items": 1
}
```

#### 400 - Bad request

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 401 - Unauthorized

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

#### 500 - Internal server error

**Response Schema:**

- `error` (object) *(required)*
  - `message` (string) *(required)*
  - `code` (number) *(required)*
  - `slug` (string) *(required)*
  - `status` (number) *(required)*
  - `request_id` (string)
  - `suggested_fix` (string)
  - `errors` (array<string>)

### Example cURL Request

```bash
curl -X GET "https://backend.composio.dev/api/v3/trigger_instances/active" \
  -H "x-api-key: YOUR_API_KEY"
```