---
title: "List a signup's notifications"
description: "List every notification sent for one back-in-stock signup, oldest first, with each channel's delivery events (sent, delivered, opened, clicked, bounced)."
url: https://docs.stoqapp.com/v2-reference/back-in-stock-signups/list-a-signups-notifications/
api: "API v2 reference"
method: GET
path: "/back_in_stock/signups/{id}/history"
---

# List a signup's notifications

`GET https://app.stoqapp.com/api/v2/external/back_in_stock/signups/{id}/history`

List every notification sent for one back-in-stock signup, oldest first, with each channel's delivery events (sent, delivered, opened, clicked, bounced).

**Note:** Each entry's `id` is a notification id for [`GET /back_in_stock/notifications/:id`](https://docs.stoqapp.com/v2-reference/back-in-stock-notifications/get-a-sent-notification/), which says whether that send was blocked and why. `channels` has one item per channel used, and its timestamps are null until the provider reports that event. `provider` is `stoq` for STOQ's own sending, or the integration's name (such as `klaviyo` or `postscript`) when one sent it. For the shop-wide send log, use [`GET /back_in_stock/notifications`](https://docs.stoqapp.com/v2-reference/back-in-stock-notifications/list-sent-notifications/). An unknown signup id gives 404 `not_found`.

## Path parameters

- `id` (string, required): The signup's ID, from [`GET /back_in_stock/signups`](https://docs.stoqapp.com/v2-reference/back-in-stock-signups/list-signups/).

## Returns

- `signup_id` (string): Id of the signup acted on.
- `history` (array of objects): Every notification sent for this signup, oldest first.
  - `id` (string): Notification id.
  - `source` (string): What sent it: the restock send's source (see trigger_source) when one started it, else how it was sent (campaign_template, send or resend from one signup row).
  - `trigger_source` (null): Source of the restock or bulk send that sent it (webhook, bulk_send, bulk_resend, flow_action, ...); null when it was sent on its own.
  - `template_position` (integer): Which message of the alert sequence this was: 0 is the back-in-stock alert, higher numbers are reminders.
  - `notified_at` (null): When the notification was sent; null when it was not sent, for example blocked by the plan limit.
  - `created_at` (string): When the notification was created.
  - `triggered_at` (null): When the restock or bulk send that sent it started; null when it was sent on its own.
  - `channels` (array of objects): The message sent on each channel, with its delivery events.
    - `type` (string): Channel of this message. One of: `email`, `sms`.
    - `sent_at` (null): When the provider accepted the message; null if not yet.
    - `delivered_at` (null): When the message was delivered; null if not (yet) reported.
    - `opened_at` (null): When the email was first opened; null if not opened. Email only.
    - `clicked_at` (null): When a link in the message was first clicked; null if never.
    - `bounced_at` (null): When the email bounced; null if it did not. Email only.
    - `provider` (string): Who delivered the message: stoq for STOQ's own senders, else the integration (klaviyo, flow, postscript).
    - `provider_fallback_reason` (string, nullable): Why the merchant's chosen provider was not used (e.g. credentials_missing, flow_unverified); null when it was.

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/back_in_stock/signups/string/history" \
  -H "X-Auth-Token: $STOQ_API_KEY"
```

## 200

Success: the requested resource.

```json
{
  "signup_id": "string",
  "history": [
    {
      "id": "string",
      "source": "string",
      "trigger_source": null,
      "template_position": 1,
      "notified_at": null,
      "created_at": "2026-01-15T09:30:00Z",
      "triggered_at": null,
      "channels": [
        {
          "type": "email",
          "sent_at": null,
          "delivered_at": null,
          "opened_at": null,
          "clicked_at": null,
          "bounced_at": null,
          "provider": "string",
          "provider_fallback_reason": "string"
        }
      ]
    }
  ]
}
```

## 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
    }
  ]
}
```

