---
title: "List Twilio integration accounts"
method: GET
path: "/api/v2/integration-interfaces/twilio/accounts"
tags: ["Twilio Integration"]
---

# List Twilio integration accounts

`GET /api/v2/integration-interfaces/twilio/accounts`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/integration-interfaces/twilio/accounts`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token`
- TypeScript: <https://skmtc.dev/datadog/apis/datadog-api-v2-collection/docs/api/v2/integration-interfaces/twilio/accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

List Twilio integration accounts.

## Response `200`

OK

- TwilioIntegrationAccountsResponse: Response payload for a list of Twilio integration accounts.
  - `data` TwilioIntegrationAccountResponseData[], required: List of Twilio integration accounts.
    - `attributes` TwilioIntegrationAccountResponseAttributes, required: Attributes of a Twilio integration account returned in responses.
      - `authentication` TwilioIntegrationAccountAuthenticationResponse: The basic authentication method and username configured on the account.
        - `auth_type` 'basic', required: The authentication method type.
        - `username` string, required: Non-secret username or public identifier for the credential pair.
      - `dataflows` TwilioIntegrationDataflowsResponse: Data Datadog collects from Twilio, keyed by dataflow id.
        - `twilio-alerts-logs` TwilioAlertsLogsIntegrationDataflowResponse: Twilio Alert resource logs, which detail the errors and warnings raised when Twilio makes a webhook request to your server or when your application calls the Twilio REST API.
          - `enabled` boolean: Whether Datadog collects this data.
          - `status` IntegrationAccountDataflowStatus: Read-only collection status of a dataflow.
            - `health` 'DATAFLOW_HEALTH_OK' | 'DATAFLOW_HEALTH_BROKEN' | 'DATAFLOW_HEALTH_UNKNOWN': Collection health of a single dataflow.
            - `message` string: Human-readable detail, populated when the dataflow is not healthy.
            - `updated_at` string, date-time: Time the status was last computed.
        - `twilio-call-summaries-logs` TwilioCallSummariesLogsIntegrationDataflowResponse: Twilio Call Summary resource logs, covering the metadata and performance of the calls made from your Twilio account. Requires Voice Insights Advanced Features to be enabled on the Twilio account; without it this dataflow collects no data.
          - `enabled` boolean: Whether Datadog collects this data.
          - `status` IntegrationAccountDataflowStatus: Read-only collection status of a dataflow.
            - `health` 'DATAFLOW_HEALTH_OK' | 'DATAFLOW_HEALTH_BROKEN' | 'DATAFLOW_HEALTH_UNKNOWN': Collection health of a single dataflow.
            - `message` string: Human-readable detail, populated when the dataflow is not healthy.
            - `updated_at` string, date-time: Time the status was last computed.
        - `twilio-cloud-cost-metrics` TwilioCloudCostMetricsIntegrationDataflowResponse: Your Twilio cost data, so that Twilio spend can be broken down and attributed in [Cloud Cost Management](https://docs.datadoghq.com/cloud_cost_management/).
          - `enabled` boolean: Whether Datadog collects this data.
          - `status` IntegrationAccountDataflowStatus: Read-only collection status of a dataflow.
            - `health` 'DATAFLOW_HEALTH_OK' | 'DATAFLOW_HEALTH_BROKEN' | 'DATAFLOW_HEALTH_UNKNOWN': Collection health of a single dataflow.
            - `message` string: Human-readable detail, populated when the dataflow is not healthy.
            - `updated_at` string, date-time: Time the status was last computed.
        - `twilio-events-logs` TwilioEventsLogsIntegrationDataflowResponse: Twilio Event resource logs, which record virtually every action taken in your Twilio account, such as provisioning a phone number, changing account security settings, or deleting a recording. Actions are recorded whether they came from the REST API, a user in the Twilio Console, or Twilio itself. [Cloud SIEM](https://docs.datadoghq.com/security/cloud_siem/) analyzes and correlates these logs to detect threats in real time.
          - `enabled` boolean: Whether Datadog collects this data.
          - `status` IntegrationAccountDataflowStatus: Read-only collection status of a dataflow.
            - `health` 'DATAFLOW_HEALTH_OK' | 'DATAFLOW_HEALTH_BROKEN' | 'DATAFLOW_HEALTH_UNKNOWN': Collection health of a single dataflow.
            - `message` string: Human-readable detail, populated when the dataflow is not healthy.
            - `updated_at` string, date-time: Time the status was last computed.
        - `twilio-messages-logs` TwilioMessagesLogsIntegrationDataflowResponse: Twilio Message resource logs for inbound and outbound messages, used to track delivery and troubleshoot message errors. A log is produced when you send a message through the REST API, when Twilio executes a TwiML instruction, and when someone messages one of your Twilio numbers or channel addresses. Message bodies are never collected.
          - `enabled` boolean: Whether Datadog collects this data.
          - `status` IntegrationAccountDataflowStatus: Read-only collection status of a dataflow.
            - `health` 'DATAFLOW_HEALTH_OK' | 'DATAFLOW_HEALTH_BROKEN' | 'DATAFLOW_HEALTH_UNKNOWN': Collection health of a single dataflow.
            - `message` string: Human-readable detail, populated when the dataflow is not healthy.
            - `updated_at` string, date-time: Time the status was last computed.
      - `name` string, required: Human-readable name of the Twilio integration account.
      - `settings` TwilioIntegrationAccountSettingsResponse, required: Settings configured on the Twilio integration account.
        - `account_sid` string, required: Twilio Account SID that uniquely identifies your Twilio account.
        - `censor_logs` boolean: When enabled, Twilio phone numbers in the `to` field and SMS message bodies are censored for privacy.
    - `id` string, required: Server-generated unique identifier of the Twilio integration account.
    - `type` 'integration-account', required: The type of the integration account resource. Always `integration-account`.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/3f70db624329?raw)