---
title: "Show a single invoice"
method: GET
path: "/V1/invoices/{id}"
tags: ["Invoices"]
---

# Show a single invoice

`GET /V1/invoices/{id}`

## Request

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

## Response `200`

lookup by decorated invoice_number

- 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

## Other responses

- `404`: unknown invoice

---

[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)