List sales [+]
Studio
List sales [+]
Paginated, filterable list of your studio’s orders, buyer, product, and amount breakdown per sale.
GET
List sales [+]
Returns your studio’s orders, one row per sale, with the same buyer/product/amount breakdown the dashboard’s Orders table shows.
Tier: Premium, requires a premium key and an active Branding+ subscription (checked on every request).
Request
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
| 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. |
Amounts on this endpoint are formatted USD strings (
"$14.99"). For numeric values suited to charts and math, use Sales summary or Analytics timeseries.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. |