---
title: "Get Subscription Orders"
method: GET
path: "/v1/subscriptions/orders"
tags: ["Subscriptions"]
---

# Get Subscription Orders

`GET /v1/subscriptions/orders`

List subscription orders (billing cycles) for the authenticated merchant division.

## Query parameters

- `seller_id` string
- `subscription_ids` string
- `order_ids` string

## Headers

- `X-Publishable-Key` string, required
- `X-Bolt-Connect-Seller-Id` string

## Response `200`

Success

- SubscriptionV2OrderList — A list of subscription orders.
  - `orders` SubscriptionV2Order[], required
    - `id` string, required — The unique ID for the subscription order.
    - `subscription_id` string, required — The unique ID for a Bolt subscription.
    - `order_id` integer — The associated Bolt order ID, once the order has been placed.
    - `transaction_reference` string, required — The transaction reference for this order's payment attempt.
    - `placement_time` string, date-time, required — The scheduled or actual placement time of this order.
    - `status` 'scheduled' | 'done' | 'paused' | 'payment_failed' | 'canceled', required — The status of a subscription order.
    - `cancel_reason` string, nullable — Deprecated.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `sequence_number` integer, required — The 1-indexed position of this order within the subscription's billing history.
    - `total_amount` Amounts — The amount. **Nullable** for Transactions Details.
      - `amount` integer, required — The amount in cents. **Nullable** for Transactions Details.
      - `currency` string, required — The 3-digit ISO code for the currency. **Nullable** for Transactions Details.
      - `currency_symbol` string, required — The currency symbol used for the amount. **Nullable** for Transactions Details.

## Other responses

- `400` — BAD REQUEST. Request is malformed, such as a non-numeric value in `order_ids`.
- `401` — UNAUTHORIZED. Missing or invalid X-API-Key or X-Publishable-Key.

## Changes

- **2026-07-31** `1f62c40558c6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bolt/apis/bolt-api-reference/changes/v1/subscriptions/orders/get.md)

---

[API](https://skmtc.dev/bolt/apis/bolt-api-reference.md) · [All operations](https://skmtc.dev/bolt/apis/bolt-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bolt/bolt-api-reference/revisions/1f62c40558c6/schema)