---
title: "List orders eligible for the weekly client budget export"
method: GET
path: "/V1/orders"
tags: ["Orders"]
---

# List orders eligible for the weekly client budget export

`GET /V1/orders`

Returns orders with their items. Supports filtering by customer (Plunet id), completion state (all items approved), and incremental polling via updated_since.

## Query parameters

- `customer_plunet_id` integer
- `all_items_approved` boolean
- `updated_since` string, date-time
- `page` integer
- `per_page` integer

## Response `200`

matching orders

- object
  - `data` Order[]
    - `id` string, nullable — Plunet order id
    - `plunet_id` string, nullable — Same as id
    - `order_reference` string
    - `quote_number` string, nullable — Source quote's order_reference, if the order originated from a quote.
    - `project_name` string, nullable
    - `project_manager_memo` string, nullable
    - `properties` object, nullable — Internal metadata (TMS jobs, CAT info, job dates).
    - `status` string, nullable
    - `all_items_approved` boolean
    - `client` Customer
      - `id` integer, nullable — Plunet customer id
      - `name` string, required
    - `contact_person` object, nullable
      - `id` string, uuid
      - `full_name` string
      - `email` string, email
    - `currency` string, nullable — Internal currency (always EUR).
    - `total_price` number, float, nullable — Order total in internal currency (EUR).
    - `client_ccy` string, nullable — Customer-facing currency (matches the PDF invoice/quote).
    - `total_price_in_client_ccy` number, float, nullable — Order total in the customer-facing currency.
    - `due_date` string, date-time, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `items` OrderItem[]
      - `id` string, nullable — Plunet item id
      - `plunet_id` string, nullable — Same as id
      - `language_source` string, nullable
      - `language_target` string, nullable
      - `quantity` number, float, nullable
      - `price` number, float, nullable — Item price in internal currency (EUR).
      - `currency` string, nullable — Internal currency (always EUR).
      - `client_price` number, float, nullable — Item price in the customer-facing currency (matches the PDF).
      - `client_currency` string, nullable — Customer-facing currency on the item.
      - `status` string
  - `meta` PaginationMeta
    - `total` integer
    - `page` integer
    - `per_page` integer

## Other responses

- `401` — unauthenticated

---

[API](https://skmtc.net/worders/apis/worders-api-v1.md) · [All operations](https://skmtc.net/worders/apis/worders-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/worders/worders-api-v1/revisions/310150fbd68d/schema)