---
title: "List invoices"
method: GET
path: "/V1/invoices"
tags: ["Invoices"]
---

# List invoices

`GET /V1/invoices`

Returns invoices mirroring the invoice PDF. Items are flattened with grouping fields (requester, order_reference, project_name) so the consumer can group freely.

## Query parameters

- `customer_plunet_id` integer
- `status` string
- `updated_since` string, date-time
- `page` integer
- `per_page` integer

## Response `200`

matching invoices

- object
  - `data` Invoice[]
    - `invoice_number` string, nullable
    - `created_at` string, date-time
    - `payment_due_date` string, date, nullable
    - `payment_date` string, date, nullable
    - `description` string, nullable
    - `po_number` string, nullable
    - `client_ccy` string, nullable
    - `status` string, nullable
    - `totals` object
      - `net` number, float, nullable
      - `outgoing` number, float, nullable
      - `paid` number, float, nullable
    - `customer` QuoteCustomer, nullable
      - `plunet_id` integer, nullable
      - `name` string
      - `address` string, nullable
    - `payment_request_id` string, uuid, nullable
    - `items` InvoiceLine[]
      - `requester` string, nullable — Order contact person full name.
      - `order_reference` string, nullable — Falls back to the originating quote order_reference.
      - `project_name` string, nullable
      - `description` string, nullable
      - `total_price` number, float, nullable — Line total in the customer-facing currency.
      - `order_item` QuoteItem
        - `id` string, nullable — Plunet item id
        - `plunet_id` string, nullable — Same as id
        - `language_source` string, nullable
        - `language_target` string, nullable
        - `client_price` number, float, nullable — Item price in the customer-facing currency.
        - `status` string, nullable
        - `price_line` PriceLineEntry[]
          - `price_unit_id` integer, nullable
          - `service` string, nullable
          - `unit` string, nullable
          - `amount` number, float
          - `unit_price` number, float
          - `total` number, float
  - `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)