GET /v1/Events

Debugger events

Returns a list of events in the account, sorted by event-date.

Query parameters

  • ActorSid string

    Only include events initiated by this Actor. Useful for auditing actions taken by specific users or API credentials.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^US[0-9a-fA-F]{32}$.

  • EventType string

    Only include events of this Event Type.

  • ResourceSid string

    Only include events that refer to this resource. Useful for discovering the history of a specific resource.

    Minimum length is 34, maximum length is 34. Format should match the following pattern: ^[a-zA-Z]{2}[0-9a-fA-F]{32}$.

  • SourceIpAddress string

    Only include events that originated from this IP address. Useful for tracking suspicious activity originating from the API or the Twilio Console.

  • StartDate string(date-time)

    Only include events that occurred on or after this date. Specify the date in GMT and ISO 8601 format.

  • EndDate string(date-time)

    Only include events that occurred on or before this date. Specify the date in GMT and ISO 8601 format.

  • PageSize integer

    How many resources to return in each list page. The default is 50, and the maximum is 1000.

    Minimum value is 1, maximum value is 1000.

Responses

  • 200 application/json

    OK

    Hide response attributes Show response attributes object
    • events array[object]
      Hide events attributes Show events attributes object
      • account_sid string | null

        The SID of the Account that created the resource

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AC[0-9a-fA-F]{32}$.

      • actor_sid string | null

        The SID of the actor that caused the event, if available

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^US[0-9a-fA-F]{32}$.

      • actor_type string | null

        The type of actor that caused the event

      • description string | null

        A description of the event

      • event_data

        A JSON string that represents an object with additional data about the event

      • event_date string(date-time) | null

        The ISO 8601 date and time in GMT when the event was recorded

      • event_type string | null

        The event's type

      • resource_sid string | null

        The SID of the resource that was affected

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^[a-zA-Z]{2}[0-9a-fA-F]{32}$.

      • resource_type string | null

        The type of resource that was affected

      • sid string | null

        The unique string that identifies the resource

        Minimum length is 34, maximum length is 34. Format should match the following pattern: ^AE[0-9a-fA-F]{32}$.

      • source string | null

        The originating system or interface that caused the event

      • source_ip_address string | null

        The IP address of the source

      • url string(uri) | null

        The absolute URL of the resource that was affected

    • meta object
      Hide meta attributes Show meta attributes object
      • first_page_url string(uri)
      • key string
      • next_page_url string(uri)
      • page integer
      • page_size integer
      • previous_page_url string(uri)
      • url string(uri)
GET /v1/Events
curl \
 --request GET 'https://monitor.twilio.com/v1/Events' \
 --user "username:password"
Response examples (200)
{
  "events": [
    {
      "account_sid": "string",
      "actor_sid": "string",
      "actor_type": "string",
      "description": "string",
      "event_date": "2026-05-04T09:42:00Z",
      "event_type": "string",
      "links": {},
      "resource_sid": "string",
      "resource_type": "string",
      "sid": "string",
      "source": "string",
      "source_ip_address": "string",
      "url": "https://example.com"
    }
  ],
  "meta": {
    "first_page_url": "https://example.com",
    "key": "string",
    "next_page_url": "https://example.com",
    "page": 42,
    "page_size": 42,
    "previous_page_url": "https://example.com",
    "url": "https://example.com"
  }
}