---
title: "Retrieve signups"
description: "The Back in stock Overview signups chart: back-in-stock signups created per day, week or month."
url: https://docs.stoqapp.com/v2-reference/back-in-stock-reports/retrieve-signups/
api: "API v2 reference"
method: GET
path: "/back_in_stock/reports/signups"
---

# Retrieve signups

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

The Back in stock Overview signups chart: back-in-stock signups created per day, week or month.

**Note:** The same points as the dashboard chart. One signup is one person waiting on one variant, so email and SMS for the same variant count once. interval is daily up to 60 days, weekly up to 180, then monthly, and buckets are UTC days as on the chart. range=all_time is the dashboard's All time.

## Query parameters

- `from` (string)
- `to` (string)
- `range` (string)

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

## 200

Success: the requested resource.

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