---
title: "Retrieve a list of usage-triggers belonging to the account used to make the request"
method: GET
path: "/2010-04-01/Accounts/{AccountSid}/Usage/Triggers.json"
tags: ["Api20100401Trigger"]
---

# Retrieve a list of usage-triggers belonging to the account used to make the request

`GET /2010-04-01/Accounts/{AccountSid}/Usage/Triggers.json`

## Request

- Base URL: `https://api.twilio.com`
- URL: `https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Usage/Triggers.json`
- Auth: HTTP basic

Retrieve a list of usage-triggers belonging to the account used to make the request

## Path parameters

- `AccountSid` string, required

## Query parameters

- `Recurring` 'daily' | 'monthly' | 'yearly' | 'alltime': The frequency of a recurring UsageTrigger. Can be: `daily`, `monthly`, or `yearly` for recurring triggers or empty for non-recurring triggers. A trigger will only fire once during each period. Recurring times are in GMT.
- `TriggerBy` 'count' | 'usage' | 'price': The field in the [UsageRecord](https://www.twilio.com/docs/usage/api/usage-record) resource that fires the trigger. Can be: `count`, `usage`, or `price`, as described in the [UsageRecords documentation](https://www.twilio.com/docs/usage/api/usage-record#usage-count-price).
- `UsageCategory` string
- `PageSize` integer
- `Page` integer
- `PageToken` string

## Response `200`

OK

- object
  - `end` integer
  - `first_page_uri` string, uri
  - `next_page_uri` string, uri, nullable
  - `page` integer
  - `page_size` integer
  - `previous_page_uri` string, uri, nullable
  - `start` integer
  - `uri` string, uri
  - `usage_triggers` ApiV2010AccountUsageUsageTrigger[]
    - `account_sid` string, nullable: The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that the trigger monitors.
    - `api_version` string, nullable: The API version used to create the resource.
    - `callback_method` 'GET' | 'POST', http-method, nullable: The HTTP method we use to call `callback_url`. Can be: `GET` or `POST`.
    - `callback_url` string, uri, nullable: The URL we call using the `callback_method` when the trigger fires.
    - `current_value` string, nullable: The current value of the field the trigger is watching.
    - `date_created` string, date-time-rfc-2822, nullable: The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
    - `date_fired` string, date-time-rfc-2822, nullable: The date and time in GMT that the trigger was last fired specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
    - `date_updated` string, date-time-rfc-2822, nullable: The date and time in GMT that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
    - `friendly_name` string, nullable: The string that you assigned to describe the trigger.
    - `recurring` 'daily' | 'monthly' | 'yearly' | 'alltime': The frequency of a recurring UsageTrigger. Can be: `daily`, `monthly`, or `yearly` for recurring triggers or empty for non-recurring triggers. A trigger will only fire once during each period. Recurring times are in GMT.
    - `sid` string, nullable: The unique string that that we created to identify the UsageTrigger resource.
    - `trigger_by` 'count' | 'usage' | 'price': The field in the [UsageRecord](https://www.twilio.com/docs/usage/api/usage-record) resource that fires the trigger. Can be: `count`, `usage`, or `price`, as described in the [UsageRecords documentation](https://www.twilio.com/docs/usage/api/usage-record#usage-count-price).
    - `trigger_value` string, nullable: The value at which the trigger will fire. Must be a positive, numeric value.
    - `uri` string, nullable: The URI of the resource, relative to `https://api.twilio.com`.
    - `usage_category` string, nullable: The usage category the trigger watches. Must be one of the supported [usage categories](https://www.twilio.com/docs/usage/api/usage-record#usage-categories).
    - `usage_record_uri` string, nullable: The URI of the [UsageRecord](https://www.twilio.com/docs/usage/api/usage-record) resource this trigger watches, relative to `https://api.twilio.com`.

## Changes

- **2025-09-04** (v2010) `5a1f9bff7440`: 644 breaking, 643 info
  - removed the enum value `a2p-10dlc-registrationfees-brandregistration` from the `query` request parameter `UsageCategory`
  - removed the enum value `a2p-10dlc-registrationfees-bv` from the `query` request parameter `UsageCategory`
  - removed the enum value `a2p-10dlc-registrationfees-campaigncharges` from the `query` request parameter `UsageCategory`
  - removed the enum value `a2p-10dlc-registrationfees-campaignregistration` from the `query` request parameter `UsageCategory`
  - …1283 more
- **2025-08-18** (v2010) `9dd521c52691`: 6 warning, 6 info
  - added the new `channels-whatsapp-service` enum value to the `usage_triggers/items/usage_category` response property for the response status `200`
  - added the new `channels-whatsapp-template-authentication` enum value to the `usage_triggers/items/usage_category` response property for the response status `200`
  - added the new `channels-whatsapp-template-marketing` enum value to the `usage_triggers/items/usage_category` response property for the response status `200`
  - added the new `channels-whatsapp-template-service` enum value to the `usage_triggers/items/usage_category` response property for the response status `200`
  - …8 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/twilio/apis/api-v2010/changes/2010-04-01/Accounts/:AccountSid/Usage/Triggers.json/get.md)

---

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