Skip to main content
GET
/
api
/
workspace
/
{workspaceId}
/
billing
/
usage
Get usage statistics over time
curl --request GET \
  --url https://app.alana.shopping/api/workspace/{workspaceId}/billing/usage \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "month": "<string>",
      "label": "<string>",
      "skuCount": 123
    }
  ],
  "currentTotal": 123,
  "aiMediaUsage": {},
  "period": {
    "start": "<string>",
    "end": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Bearer token authentication via Auth0. Users authenticate through Auth0 Universal Login. Include the access token in the Authorization header: Authorization: Bearer <token>

Path Parameters

workspaceId
string
required

The workspace ID

Pattern: ^ws_[a-z0-9]+$

Query Parameters

months
integer
default:6

Number of months to include in history

Required range: 1 <= x <= 12

Response

Usage statistics retrieved successfully

data
object[]

Cumulative SKU count by month

currentTotal
integer

Total active SKUs today

aiMediaUsage
object

Per-provider AI media usage for the current billing month

period
object
Last modified on March 22, 2026