> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nmcrate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List sales [+]

> Paginated, filterable list of your studio's orders, buyer, product, and amount breakdown per sale.

Returns your studio's orders, one row per sale, with the same buyer/product/amount breakdown the dashboard's Orders table shows.

<Info>
  **Tier:** Premium, requires a premium key **and** an active Branding+ subscription (checked on every request).
</Info>

## Request

```bash theme={null}
curl "https://nmcrate.com/api/public/v1/studio/sales?limit=20&from=2026-06-01" \
  -H "x-api-key: nmk_studio_..."
```

### Query parameters

| Parameter | Type    | Default     | Description                                                                                                |
| --------- | ------- | ----------- | ---------------------------------------------------------------------------------------------------------- |
| `page`    | integer | `1`         | Page number (1-indexed on this endpoint).                                                                  |
| `limit`   | integer | `20`        | Items per page, max `100`.                                                                                 |
| `status`  | string  | `COMPLETED` | Transaction status filter; pass `ALL` for everything. The default mirrors the dashboard's revenue figures. |
| `from`    | date    | ,           | Start date (inclusive), e.g. `2026-06-01`.                                                                 |
| `to`      | date    | ,           | End date (inclusive).                                                                                      |
| `q`       | string  | ,           | Free-text search over the order reference and your product names.                                          |

## Response

```json theme={null}
{
  "items": [
    {
      "id": "ord_1a2b3c",
      "customer": "Steve",
      "product": "Dungeon Pack",
      "amount": "$11.24",
      "gross": "$14.99",
      "fee": "$2.25",
      "tax": "$1.50",
      "net": "$11.24",
      "taxCountry": "DE",
      "taxRatePercent": 19,
      "status": "completed",
      "createdAt": "2026-07-01T14:03:22.000Z",
      "date": "12 days ago"
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 342,
  "totalPages": 18
}
```

| Field            | Description                             |
| ---------------- | --------------------------------------- |
| `gross`          | What the buyer paid.                    |
| `fee`            | Platform cut.                           |
| `tax`            | VAT withheld on the sale.               |
| `net` / `amount` | What was credited to the studio wallet. |

<Note>
  Amounts on this endpoint are **formatted USD strings** (`"$14.99"`). For numeric values suited to charts and math, use [Sales summary](/publicapi/docs/get-sales-summary) or [Analytics timeseries](/publicapi/docs/get-analytics-timeseries).
</Note>

## Errors

| HTTP | Code                    | When                                                             |
| ---- | ----------------------- | ---------------------------------------------------------------- |
| 403  | `PREMIUM_KEY_REQUIRED`  | The key is basic-tier.                                           |
| 403  | `SUBSCRIPTION_INACTIVE` | Premium key, but the Branding+ subscription is no longer active. |