---
title: "List an order's notifications"
description: "Read which customer messages were sent for an order: confirmation email and SMS, shipping update email, with counts and when each was last sent."
url: https://docs.stoqapp.com/v2-reference/preorders-orders/list-an-orders-notifications/
api: "API v2 reference"
method: GET
path: "/preorders/orders/{id}/notifications"
---

# List an order's notifications

`GET https://app.stoqapp.com/api/v2/external/preorders/orders/{id}/notifications`

Read which customer messages were sent for an order: confirmation email and SMS, shipping update email, with counts and when each was last sent.

**Note:** Counts include the automatic send when the order comes in and every resend from the dashboard or the API, single or bulk; `last_triggered_by` is `automatic` or `manual`. An email counts once it is queued for sending, so a count does not prove delivery. An SMS counts only when the SMS provider accepted it. Check `sent_count` before [`POST /preorders/orders/:id/send_confirmation`](https://docs.stoqapp.com/v2-reference/preorders-orders/resend-confirmation-email/) or .../send_sms_confirmation to avoid a duplicate. [`GET /preorders/orders/:id/timeline`](https://docs.stoqapp.com/v2-reference/preorders-orders/get-an-orders-timeline/) lists each send with its recipient.

## Path parameters

- `id` (string, required): The order, by STOQ's order ID or the Shopify order ID.

## Returns

- `confirmation_email` (object): The preorder confirmation email.
  - `sent_count` (integer): How many times it was sent for this order.
  - `last_sent_at` (string): When it was last sent (ISO 8601), or null when it never was.
  - `last_triggered_by` (string): What sent it last, such as automatic or manual. Null when it was never sent.
- `confirmation_sms` (object): The preorder confirmation SMS.
  - `sent_count` (integer): How many times it was sent for this order.
  - `last_sent_at` (null): When it was last sent (ISO 8601), or null when it never was.
  - `last_triggered_by` (null): What sent it last, such as automatic or manual. Null when it was never sent.
- `shipping_update_email` (object): The shipping update email.
  - `sent_count` (integer): How many times it was sent for this order.
  - `last_sent_at` (null): When it was last sent (ISO 8601), or null when it never was.
  - `last_triggered_by` (null): What sent it last, such as automatic or manual. Null when it was never sent.

Rate limit: this call costs 1 point ([rate limits](https://docs.stoqapp.com/docs/rate-limits/)).

## Example request

```sh
curl "https://app.stoqapp.com/api/v2/external/preorders/orders/5f0c8a3e-6b2d-4f1a-9c7e-2d8b1a4e6f30/notifications" \
  -H "X-Auth-Token: $STOQ_API_KEY"
```

## 200

Success: the requested resource.

```json
{
  "confirmation_email": {
    "sent_count": 1,
    "last_sent_at": "2026-01-15T09:30:00Z",
    "last_triggered_by": "string"
  },
  "confirmation_sms": {
    "sent_count": 1,
    "last_sent_at": null,
    "last_triggered_by": null
  },
  "shipping_update_email": {
    "sent_count": 1,
    "last_sent_at": null,
    "last_triggered_by": null
  }
}
```

## 401

Missing or invalid `X-Auth-Token`.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "auth_invalid",
  "details": [
    {
      "code": "auth_invalid",
      "message": "Invalid API key",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 404

The resource does not exist for this shop, or the action path is not registered.

```json
{
  "errors": [
    "Offer not found"
  ],
  "code": "not_found",
  "details": [
    {
      "code": "not_found",
      "message": "Offer not found",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 422

The request failed validation.

```json
{
  "errors": [
    "name is required"
  ],
  "code": "validation_failed",
  "details": [
    {
      "code": "validation_failed",
      "message": "name is required",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

## 429

Rate limited: cost-weighted per token (read 1, write 2; 360 points / 60s). Check `Retry-After`.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited",
  "details": [
    {
      "code": "rate_limited",
      "message": "Rate limit exceeded",
      "path": null,
      "value": null,
      "expected": null
    }
  ]
}
```

