# Get outgoing e-mail

Returns a single outgoing e-mail integration by ID.

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

[[path_param]]
name = "integration_id"
description = "The ID of the outgoing e-mail integration."
required = true
type = "string"

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

[responses]
[[response]]
status = 200
description = '''Returns the requested outgoing e-mail integration'''
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."
        }
      ]
    }
  }
}'''

[/responses]

#### Example cURL

```shell
[label Example]
curl --request GET \
  --url https://incidents.betterstack.com/api/v2/outgoing-emails/42 \
  --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]