---
title: "List the orders of the account (subscription, seats, assistants, credit)"
method: GET
path: "/api/v1/orders"
---

# List the orders of the account (subscription, seats, assistants, credit)

`GET /api/v1/orders`

## Request

- Base URL: `https://smartwebchat.eu`
- URL: `https://smartwebchat.eu/api/v1/orders`
- Auth: HTTP bearer

Derived from the payment notifications of Digistore24. Newest first by last event. amount and currency are passed through as delivered by the payment provider (strings, not parsed). fulfillment is pending while a notification could not be applied yet; the provider retries it. Invoices are issued by Digistore24 and are not available via this API.

## Query parameters

- `limit` integer

## Response `200`

Orders

- object
  - `data` object
    - `orders` Order[]
      - `id` string: Digistore24 order id
      - `kind` 'subscription' | 'seat' | 'assistant' | 'credit'
      - `status` 'paid' | 'payment_failed' | 'cancelled' | 'refunded' | 'chargeback'
      - `fulfillment` 'applied' | 'pending'
      - `amount` string, nullable
      - `currency` string, nullable
      - `payments` integer
      - `firstEventAt` string, date-time
      - `lastEventAt` string, date-time
    - `truncated` boolean
  - `error` unknown

## Other responses

- `400`: limit out of range
- `401`: Missing or invalid API key
- `403`: Delegated access token without billing:read
- `429`: Rate limit exceeded: 600 requests per minute per account across all /api/v1/ routes. Wait for the seconds given in Retry-After (60) and retry.

---

[API](https://skmtc.dev/smartwebchat/apis/smartwebchat-api.md) · [All operations](https://skmtc.dev/smartwebchat/apis/smartwebchat-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smartwebchat/apis/smartwebchat-api/revisions/1b052502dacb?raw)