List Emails | Twilio

curl https://comms.twilio.com/v1/Emails \
     -u "<accountId>:<authToken>"

{
  "emails": [
    {
      "bcc": [],
      "cc": [
        {
          "address": "jane.doe@example.com",
          "name": "Jane Doe"
        }
      ],
      "createdAt": "2023-08-24T14:15:22Z",
      "deletedAt": "2024-01-15T09:30:00Z",
      "from": {
        "address": "support@example.com",
        "name": "Cool Support"
      },
      "id": "comms_email_01h9krwprkeee8fzqspvwy6nq8",
      "related": [
        {
          "name": "OPERATION",
          "id": "comms_operation_01h9krwprkeee8fzqspvwy6nq8",
          "uri": "https://comms.twilio.com/v1/Emails/Operations/comms_operation_01h9krwprkeee8fzqspvwy6nq8"
        },
        {
          "name": "SESSION",
          "id": "comms_session_01h9krwprkeee8fzqspvwy6nq8",
          "uri": "https://comms.twilio.com/v1/Sessions/comms_session_01h9krwprkeee8fzqspvwy6nq8"
        },
        {
          "name": "SENDER",
          "id": "comms_sender_01h9krwprkeee8fzqspvwy6nq8",
          "uri": "https://comms.twilio.com/v1/Senders/comms_sender_01h9krwprkeee8fzqspvwy6nq8"
        }
      ],
      "replyTo": [],
      "scheduledFor": "2024-01-15T09:30:00Z",
      "status": "OPENED",
      "tags": {},
      "to": [
        {
          "address": "janedoe@example.com",
          "name": "Jane Doe"
        }
      ],
      "updatedAt": "2023-08-24T14:15:22Z"
    },
    {
      "bcc": [],
      "cc": [],
      "createdAt": "2023-08-24T14:15:22Z",
      "deletedAt": "2024-01-15T09:30:00Z",
      "from": {
        "address": "support@example.com",
        "name": "Acme Support"
      },
      "id": "comms_email_01h9krwprkeee8fzqspvwy6nq8",
      "related": [
        {
          "name": "OPERATION",
          "id": "comms_operation_01h9krwprkeee8fzqspvwy6nq8",
          "uri": "https://comms.twilio.com/v1/Emails/Operations/comms_operation_01h9krwprkeee8fzqspvwy6nq8"
        },
        {
          "name": "SESSION",
          "id": "comms_session_01h9krwprkeee8fzqspvwy6nq8",
          "uri": "https://comms.twilio.com/v1/Sessions/comms_session_01h9krwprkeee8fzqspvwy6nq8"
        },
        {
          "name": "SENDER",
          "id": "comms_sender_01h9krwprkeee8fzqspvwy6nq8",
          "uri": "https://comms.twilio.com/v1/Senders/comms_sender_01h9krwprkeee8fzqspvwy6nq8"
        }
      ],
      "replyTo": [],
      "scheduledFor": "2024-01-15T09:30:00Z",
      "status": "OPENED",
      "tags": {},
      "to": [
        {
          "address": "janedoe@example.com",
          "name": "Jane Doe"
        }
      ],
      "updatedAt": "2023-08-24T14:15:22Z"
    }
  ],
  "pagination": {
    "next": "string",
    "self": "https://comms.twilio.com/v1/Emails"
  }
}

This operation fetches a paginated list of Emails.

Authentication

AuthorizationBasic

Basic authentication of the form Basic <account_id:auth_token>.

AuthorizationBasic

Basic authentication of the form Basic <api_key:api_key_secret>.

Query parameters

operationIdstringOptionalformat: "^comms_operation_[0-7][a-hjkmnpqrstv-z0-9]{25,34}"

Filter to Emails created in a specific Operation.

startDatestringOptionalformat: "date-time"

Filter Emails created after the specified date and time.

endDatestringOptionalformat: "date-time"

Filter Emails created before the specified date and time.

profilestringOptionalformat: "^mem_profile_[0-7][a-hjkmnpqrstv-z0-9]{25,34}"

Filter Emails sent or received by a specific Profile.

statusenumOptional

Filter Emails by Delivery Status.

tagsstringOptionalformat: "^(?:[a-zA-Z0-9._~-]+:[a-zA-Z0-9._~-]+;){1,10}$"

Match emails by one or many tags. If more than one tag is specified in the query, the search will return emails that have all the tags. For Example: GET /Emails?tags=ageGroup:20s;industry:engineering;

pageTokenstringOptional

The token to retrieve the next page of results.

pageSizeintegerOptional1-1000Defaults to 50

The number of resources to return in a page.

Response

emailslist of objects

paginationobject

Metadata for paginated results. This object contains two tokens to navigate through paginated results.

Use next to retrieve the ‘next’ page in the result list.
Use self to retrieve the same page of the result list again.
Supply the token in the pageToken query param.

Metadata for paginated results. This object contains two tokens to navigate through paginated results. - Use `next` to retrieve the 'next' page in the result list. - Use `self` to retrieve the same page of the result list again. - Supply the token in the `pageToken` query param.

Authentication

Query parameters

Response

Errors