---
title: "The workshop queue"
method: GET
path: "/v3/fulfillment/jobs"
tags: ["Fulfillment"]
---

# The workshop queue

`GET /v3/fulfillment/jobs`

## Request

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

Production jobs, oldest first. Filters: status (comma-separated: pending, sent, in_progress, done, cancelled), manufacturer_id, order_id.

## Query parameters

- `status` string
- `manufacturer_id` integer
- `order_id` integer
- `page` integer
- `limit` integer

## Response `200`

A page of jobs

- object
  - `items` ProductionJob[]
    - `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
  - `total` integer
  - `page` integer
  - `limit` integer

## Changes

- **2026-10-19** `3448a5b6797c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhinoartisan/apis/rhinoartisan-api/changes/v3/fulfillment/jobs/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)