---
title: "List the orders"
method: GET
path: "/v3/fulfillment/orders"
tags: ["Fulfillment"]
---

# List the orders

`GET /v3/fulfillment/orders`

## Request

- Base URL: `https://api.rhinoartisan.com`
- URL: `https://api.rhinoartisan.com/v3/fulfillment/orders`
- Auth: API key in header `apikey`
- TypeScript: <https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/docs/v3/fulfillment/orders/get.ts> (a function with typed inputs; its response is checked against the schema)

Most recent first. Filters: status (comma-separated), client_id, store_id and search (order number or client name).

## Query parameters

- `status` string
- `client_id` integer
- `store_id` integer
- `search` string
- `page` integer
- `limit` integer

## Response `200`

A page of orders

- object
  - `items` Order[]
    - `id` integer
    - `number` string
    - `status` 'draft' | 'quote' | 'ordered' | 'in_production' | 'ready' | 'shipped' | 'delivered' | 'cancelled'
    - `client` object, nullable
      - `id` integer
      - `name` string
      - `email` string, nullable
      - `phone` string, nullable
    - `store` object, nullable
      - `id` integer
      - `name` string
    - `seller` object, nullable
      - `id` integer
      - `name` string
    - `currency` string
    - `subtotal` number
    - `tax_name` string, nullable
    - `tax_rate` number: Percentage
    - `tax_included` boolean: Line prices already include the tax
    - `tax_amount` number
    - `total` number
    - `paid_amount` number
    - `balance` number
    - `notes` string, nullable
    - `preview` string, nullable: First piece photo (list only)
    - `lines_count` integer
    - `lines` OrderLine[]
      - `id` integer
      - `position` integer
      - `kind` 'design' | 'diamond'
      - `design_id` integer, nullable
      - `diamond_id` integer, nullable
      - `name` string
      - `preview` string, nullable
      - `quantity` integer
      - `unit_price` number
      - `line_total` number
      - `currency` string
      - `snapshot` object: The frozen piece: capsule, record, values_resolved, tech, breakdown, metal, size, engraving, stones, pricing, manufacturer
      - `cost` number, nullable: Only for Owner, Fulfillment, Merchandising and Settings
      - `markup_percentage` number, nullable: Only for Owner, Fulfillment, Merchandising and Settings
      - `manufacturer` object, nullable: Only for Owner, Fulfillment, Merchandising and Settings
        - `id` integer, nullable
        - `name` string
    - `events` OrderEvent[]
      - `id` integer
      - `kind` 'created' | 'status' | 'payment' | 'note' | 'email' | 'job' | 'shipment' | 'incident' | 'cost'
      - `status_from` string, nullable
      - `status_to` string, nullable
      - `amount` number, nullable: Payment amount, in the order currency
      - `method` 'cash' | 'card' | 'transfer' | 'other', nullable
      - `reference` string, nullable
      - `note` string, nullable
      - `author` object, nullable
        - `id` integer, nullable
        - `name` string
      - `created_at` string, date-time
    - `allowed_transitions` string[]
    - `can_produce` boolean: Every design line has a manufacturer frozen
    - `created_at` string, date-time
    - `confirmed_at` string, date-time, nullable
    - `expected_delivery_at` string, date, nullable
    - `valid_until` string, date, nullable: Quote validity
    - `expired` boolean: A quote past its validity
    - `sent_at` string, date-time, nullable: Last time it was emailed to the client
    - `shipping_carrier` string, nullable
    - `shipping_tracking` string, nullable
    - `shipping_address` string, nullable
    - `shipped_at` string, date-time, nullable
    - `jobs` ProductionJob[]: Workshop jobs (detail only)
      - `id` integer
      - `order` object: List only
        - `id` integer
        - `number` string
        - `status` string
        - `client` string, nullable
        - `expected_delivery_at` string, date, nullable
      - `line` object
        - `id` integer
        - `name` string
        - `preview` string, nullable
        - `design_id` integer, nullable
      - `manufacturer_id` integer, nullable
      - `manufacturer_name` string, nullable
      - `kind` 'production' | 'rework'
      - `status` 'pending' | 'sent' | 'in_progress' | 'done' | 'cancelled'
      - `allowed_transitions` string[]
      - `quantity` integer
      - `stl_url` string, nullable
      - `stl_status` 'ready' | 'pending' | 'failed'
      - `stl_error` string, nullable
      - `tech_sheet` object: Piece, metal, size, engraving, stones, record, tech; no prices
      - `notes` string, nullable
      - `sent_at` string, date-time, nullable
      - `started_at` string, date-time, nullable
      - `done_at` string, date-time, nullable
      - `created_at` string, date-time
      - `updated_at` string, date-time
    - `margin` object, nullable: Only for those who see costs
      - `revenue` number
      - `lines_cost` number
      - `extra_costs` number
      - `margin` number
      - `margin_pct` number, nullable
      - `lines_without_cost` integer
    - `delivered_at` string, date-time, nullable
    - `cancelled_at` string, date-time, nullable
    - `updated_at` string, date-time
  - `total` integer
  - `page` integer
  - `limit` integer

## Other responses

- `400`: INVALID_ORDER_STATUS

## Changes

- **2026-10-19** `3448a5b6797c`: 5 warning, 6 info
  - added the new `cost` enum value to the `items/items/events/items/kind` response property for the response status `200`
  - added the new `incident` enum value to the `items/items/events/items/kind` response property for the response status `200`
  - added the new `job` enum value to the `items/items/events/items/kind` response property for the response status `200`
  - added the new `shipment` enum value to the `items/items/events/items/kind` response property for the response status `200`
  - …7 more
- **2026-10-18** `6cc8e3d2d85c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/fulfillment/orders/get.md)

---

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