---
title: "List your orders"
method: GET
path: "/orders"
tags: ["Account"]
---

# List your orders

`GET /orders`

## Request

- Base URL: `https://api.quackr.io`
- URL: `https://api.quackr.io/orders`
- Auth: API key in header `x-api-key`

Your orders from the last few days, newest first: every purchase and renewal, for unlimited and per-service numbers. Each order has its order number (orderId) and the numbers it covers. Numbers that are delivered in the background after purchase show their progress here (fulfilled / inProgress / failed). Orders placed before order numbers were introduced (October 2026) may show an older id.

## Query parameters

- `lastDays` integer
- `limit` integer
- `orderId` string

## Response `200`

Your orders

- object
  - `success` boolean
  - `windowDays` integer
  - `summary` object: Totals across every order in the window, not only the returned page.
    - `totalOrders` integer
    - `totalRequested` integer
    - `totalFulfilled` integer
    - `totalInProgress` integer
    - `totalFailed` integer
  - `orders` object[]
    - `orderId` string
    - `placedAt` string, date-time: When the order was placed (ISO 8601, UTC).
    - `type` 'purchase' | 'renewal'
    - `product` 'number' | 'per-service': number: an unlimited number; per-service: a per-service number.
    - `service` string: Per-service orders only: the service.
    - `locale` string, nullable
    - `duration` string, nullable
    - `amount` number, nullable: What the order cost, in USD.
    - `quantity` integer: Numbers in the order.
    - `fulfilled` integer
    - `inProgress` integer: Numbers still being delivered.
    - `failed` integer
    - `status` 'fulfilled' | 'in_progress' | 'partially_failed' | 'failed'
    - `numbers` string[]: The numbers delivered so far.

## Other responses

- `401`: Missing or invalid API key

---

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