---
title: "List orders"
method: GET
path: "/api/v1/orders"
---

# List orders

`GET /api/v1/orders`

## Request

- Base URL: `https://ipmusk.com`
- URL: `https://ipmusk.com/api/v1/orders`
- Auth: HTTP bearer

The account's orders, newest first. Pass next_cursor back as cursor for the next page.

## Query parameters

- `cursor` string
- `limit` integer
- `product_id` 'rotating_residential' | 'static_isp'

## Response `200`

List orders

- object
  - `data` object, required
    - `items` object[], required
      - `id` string, required
      - `product_id` 'rotating_residential' | 'static_isp', required
      - `amount_minor` integer, required
      - `currency` string, required
      - `payment_status` 'not_started' | 'pending' | 'paid' | 'failed' | 'refund_pending' | 'refunded' | 'disputed', required
      - `fulfillment_status` 'draft' | 'queued' | 'provisioning' | 'allocating' | 'available' | 'failed' | 'result_unknown' | 'manual_review', required
      - `checkout_lifecycle` 'open' | 'cancel_requested' | 'cancelled' | 'expired', required
      - `checkout_expires_at` string, date-time, nullable, required
      - `checkout_close_reason` 'customer' | 'timeout', nullable, required
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
    - `next_cursor` string, nullable
  - `request_id` string, required

## Other responses

- `default`: Any failure: 400 validation_error, 401 authentication_required, 403 forbidden / capability_unavailable, 404 not_found, 409 invalid_state_transition / idempotency_conflict, 422 product_unavailable, 429 rate_limited, 500 internal_error.

---

[API](https://skmtc.dev/ipmusk/apis/ipmusk-customer-api.md) · [All operations](https://skmtc.dev/ipmusk/apis/ipmusk-customer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ipmusk/apis/ipmusk-customer-api/revisions/89f8b46fda61?raw)