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

# List invoices

`GET /V1/invoices`

## Request

- Base URL: `https://api.worders.net`
- URL: `https://api.worders.net/V1/invoices`
- Auth: one of:
  - API key in cookie `_worders_session`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/worders/apis/worders-api-v1/docs/V1/invoices/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/worders/apis/worders-api-v1.md) - [All operations](https://skmtc.dev/worders/apis/worders-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/worders/apis/worders-api-v1/revisions/ef0debe7af75?raw)