---
title: "List notification sends"
description: "List back-in-stock sends, newest first: each restock or manual send working through a variant's waitlist, with its progress (the dashboard's Bulk requests page)."
url: https://docs.stoqapp.com/v2-reference/back-in-stock-sending-history/list-notification-sends/
api: "API v2 reference"
method: GET
path: "/back_in_stock/sending_history"
---

# List notification sends

`GET https://app.stoqapp.com/api/v2/external/back_in_stock/sending_history`

List back-in-stock sends, newest first: each restock or manual send working through a variant's waitlist, with its progress (the dashboard's Bulk requests page).

**Note:** source is webhook (automatic restock alert), bulk_send (sent from the dashboard or API), bulk_resend, flow_action, events_inventory, events_products or reconciliation. status is active, waiting (between batches) or completed. sent_count of signups_count is the progress. source narrows to sends whose source contains it, as the page's source search. shopify_variant_id / shopify_product_id (gids) narrow to that variant's or product's sends; status=incomplete (active or waiting) with one of them answers whether a send is still running, as the waitlist page's banner shows.

## Query parameters

- `status` (string): Only sends in this state; incomplete means active or waiting. One of: `incomplete`, `active`, `waiting`, `completed`.
- `source` (string): Only sends whose source contains this text, e.g. webhook or bulk_send.
- `shopify_variant_id` (string): Only sends for this Shopify variant, as a gid.
- `shopify_product_id` (string): Only sends for this Shopify product, as a gid.
- `page` (integer): Page of results to return, starting at 1.
- `per_page` (integer): Results per page, 1 to 100. Default 25.

## Returns

- `sends` (array of objects)
  - `id` (string): e.g. `c3e8a1f4-7b2d-4e9a-8c51-0f6d2b9e7a13`
  - `shopify_product_id` (string): e.g. `gid://shopify/Product/8784906035384`
  - `shopify_variant_id` (string): e.g. `gid://shopify/ProductVariant/47284734423096`
  - `product_title` (string): e.g. `Trail Shoe`
  - `variant_title` (string): e.g. `Blue / Medium`
  - `shopify_location_id` (string)
  - `source` (string, nullable): e.g. `webhook`
  - `channel` (null): e.g. `email`
  - `status` (string): e.g. `waiting`
  - `limit` (null): e.g. `42`
  - `signups_count` (integer): e.g. `42`
  - `sent_count` (integer): e.g. `20`
  - `created_at` (string): e.g. `2026-06-25T14:02:11Z`
- `meta` (object): Pagination for the list.
  - `total_count` (integer): Items matching the filters, across all pages.
  - `page` (integer): Page returned, starting at 1.
  - `per_page` (integer): Most items per page.
  - `total_pages` (integer): Pages available at this per_page; 0 when nothing matches.

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

## Examples

### List notification sends

```sh
curl "https://app.stoqapp.com/api/v2/external/back_in_stock/sending_history" \
  -H "X-Auth-Token: $STOQ_API_KEY"
```

### List notification sends filtered by status, shopify_variant_id and shopify_product_id

```sh
curl "https://app.stoqapp.com/api/v2/external/back_in_stock/sending_history?status=incomplete&shopify_variant_id=45000000001&shopify_product_id=78000000001" \
  -H "X-Auth-Token: $STOQ_API_KEY"
```

## 200

Success: example response shown.

```json
{
  "sends": [
    {
      "id": "c3e8a1f4-7b2d-4e9a-8c51-0f6d2b9e7a13",
      "shopify_product_id": "gid://shopify/Product/8784906035384",
      "shopify_variant_id": "gid://shopify/ProductVariant/47284734423096",
      "product_title": "Trail Shoe",
      "variant_title": "Blue / Medium",
      "shopify_location_id": null,
      "source": "webhook",
      "channel": "email",
      "status": "waiting",
      "limit": 42,
      "signups_count": 42,
      "sent_count": 20,
      "created_at": "2026-06-25T14:02:11Z"
    },
    {
      "id": "7d2f9b4e-1a6c-4e83-b5d0-2c8a6f1e9b37",
      "shopify_product_id": "gid://shopify/Product/8784906035384",
      "shopify_variant_id": "gid://shopify/ProductVariant/47284734423096",
      "product_title": "Trail Shoe",
      "variant_title": "Blue / Medium",
      "shopify_location_id": null,
      "source": "bulk_send",
      "channel": "sms",
      "status": "completed",
      "limit": 20,
      "signups_count": 20,
      "sent_count": 20,
      "created_at": "2026-06-18T10:15:40Z"
    }
  ],
  "meta": {
    "total_count": 2,
    "page": 1,
    "per_page": 25,
    "total_pages": 1
  }
}
```

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

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

