# Get a Transactional Mailing

**GET /transactional_mailings/{transactional_mailing_id}**

Retrieve one of the notification emails Arta sent on your Organization's behalf.

A `404` answers an identifier that names no mailing this endpoint serves: one that is not well formed, one naming a mailing of another Organization, one naming a Live mailing read with a Test key or the reverse, one naming a notification type this endpoint does not serve, and one naming a mailing created more than 90 days ago.

This endpoint takes no query parameters and rejects any it is sent with a `400`. Requires API access to be enabled for your Organization, and answers `403` otherwise.


## Servers
- https://api.arta.io: https://api.arta.io ()



## Parameters
### Headers

- **Authorization** (string)
  Authorize your API calls with an Arta API token


### Path parameters

- **transactional_mailing_id** (string)
  transactional_mailing_id parameter




## Responses
### 200
Successful Transactional Mailing get response
#### Headers

- **content-type** (string)

- **x-arta-request-id** (string)
  A unique identifier for the Arta API call


#### Body: application/json (object)
- **created_at** (string)
  When Arta created the mailing, in UTC and without an offset.

- **email_rule_id** (integer | null)
  The Email Rule that produced this mailing. Retrieve it with `GET /email_rules/{email_rule_id}`. `null` when no rule produced it, or when that rule has since been deleted.

- **email_subscription_id** (integer | null)
  The Email Subscription that produced this mailing. Retrieve it with `GET /email_subscriptions/{email_subscription_id}`. `null` when no subscription produced it, or when that subscription has since been deleted.

- **id** (string(uuid))
  The mailing's identifier.

- **recipients** (array[object])
  Who the mailing was addressed to, in the order Arta addressed them.

- **request_id** (string(uuid) | null)
  The Request this mailing was sent about, if any.

- **sent_at** (string | null)
  When Arta sent the mailing, in UTC and without an offset. `null` until it is sent, so a date clause on this field returns only mailings already sent, and `sent_at:null` returns the rest.

- **shipment_id** (string(uuid) | null)
  The Shipment this mailing was sent about, if any.

- **status** (string | null)
  How far the mailing got. `sending`: the mailing is being sent. `accepted`: the mailing was sent and its delivery has not been confirmed yet. `delivered`: the recipient's mail server accepted it — only this value means the mailing reached them. `failed`: the mailing could not be delivered. The status reflects the latest outcome reported for the mailing, so a `failed` mailing can still become `delivered`. `null` means no outcome has been recorded: the send is still under way or did not complete. `status:null` returns these mailings.

- **type** (string)
  The notification this mailing carried. The values are the `id` fields of `GET /metadata/email_notifications`.


### 400
Bad Request
#### Headers

- **content-type** (string)

- **x-arta-request-id** (string)
  A unique identifier for the Arta API call


#### Body: application/json (object)
- **error** (string)
  What was at fault in the request.


### 403
Forbidden

### 404
Not Found
#### Headers

- **content-type** (string)

- **x-arta-request-id** (string)
  A unique identifier for the Arta API call


#### Body: application/json (object)
- **errors** (object)



[Powered by Bump.sh](https://bump.sh)