---
title: "Retrieve a list of Invoices"
method: GET
path: "/v2/invoices"
tags: ["Invoices"]
---

# Retrieve a list of Invoices

`GET /v2/invoices`

Retrieves a paginated list of Invoices, optionally filtered by date range.

## Query parameters

- `pageSize` number
- `page` number
- `dateProperty` 'updated' | 'created'
- `dateOperator` 'prev' | 'next' | 'between'
- `date` string

## Headers

- `Authorization` string, required

## Response `200`

A paginated list of Invoices.

- ResponseInvoicesV2Dto
  - `pageSize` number — The maximum number of items returned per page.
  - `page` number — The current page number.
  - `totalResults` number — The total number of results.
  - `hasMore` boolean — Whether there are more results.
  - `data` ResponseAllInvoiceV2Dto[] — A list of Invoices.
    - `id` string — The ID of the invoice (prefix `IV-`).
    - `uuid` string — The UUID of the invoice.
    - `serialId` number — The serial ID of the invoice.
    - `name` string — The name of the invoice.
    - `notes` string — The invoice note.
    - `jobId` string — The ID of the associated job (prefix `JOB-`).
    - `subTotal` number — The subtotal of the invoice before tax and discounts.
    - `taxableAmount` number — The taxable amount of the invoice.
    - `taxPercent` number — The tax percentage of the invoice.
    - `taxAmount` number — The tax amount of the invoice.
    - `costing` number — The cost amount of the invoice.
    - `techExpenses` number — The technician expenses of the invoice.
    - `tipAmount` number — The tip amount of the invoice.
    - `totalPrice` number — The total price of the invoice.
    - `amountDue` number — The amount due for the invoice.
    - `amountDueDate` string, date-time — The date and time when the invoice amount is due.
    - `updated` string, date-time — The date and time the invoice was last updated.
    - `created` string, date-time — The date and time the invoice was created.

## Other responses

- `400` — Invalid query parameters.
- `401` — Missing or invalid authentication token.

---

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