# List outgoing e-mails

Returns a list of all your outgoing e-mail integrations. This endpoint [supports pagination](https://betterstack.com/docs/uptime/api/pagination/).

[endpoint]
base_url = "https://incidents.betterstack.com"
path = "/api/v2/outgoing-emails"
method = "GET"

[[query_param]]
name = "team_name"
description = "Filter outgoing e-mail integrations belonging to a specified team when using a [global API token](https://betterstack.com/docs/uptime/api/getting-started-with-uptime-api/#get-a-global-api-token)."
required = false
type = "string"

[[header]]
name = "Authorization"
description = "Bearer `$TOKEN`"
required = true
type = "string"
[/endpoint]

[responses]
[[response]]
status = 200
description = '''Returns a list of existing outgoing e-mail integrations'''
body = '''{
  "data": [
    {
      "id": "42",
      "type": "outgoing_email",
      "attributes": {
        "name": "Client distribution list",
        "recipients": [
          { "email": "ops@client.com", "first_name": "Sam", "team": "SRE" },
          { "email": "noc@client.com" }
        ],
        "team_name": "My team",
        "paused": false,
        "notify_alongside_primary_responder": true,
        "on_incident_started": true,
        "on_incident_acknowledged": false,
        "on_incident_resolved": true,
        "on_incident_reopened": true,
        "on_incident_comment": false,
        "templates": [
          {
            "incident_stage": "started",
            "subject": "Incident: $NAME",
            "title": "We're investigating an issue with $NAME",
            "body": "Hi $RECIPIENT.first_name, we detected a problem: $CAUSE. Follow along at $INCIDENT_URL."
          }
        ]
      }
    }
  ],
  "pagination": {
    "first": "https://incidents.betterstack.com/api/v2/outgoing-emails?page=1",
    "last": "https://incidents.betterstack.com/api/v2/outgoing-emails?page=1",
    "prev": null,
    "next": null
  }
}'''

[/responses]

#### Example cURL

```shell
[label Example]
curl --request GET \
  --url https://incidents.betterstack.com/api/v2/outgoing-emails \
  --header "Authorization: Bearer $TOKEN"
```

[info]
#### Looking for the details of a specific parameter?
Explore [the list of all outgoing e-mail integration API parameters](https://betterstack.com/docs/uptime/api/outgoing-email-integrations-response-params/).
[/info]