---
title: "Get all invoices on a workspace"
method: GET
path: "/v1/workspaces/{workspaceId}/invoices"
tags: ["Invoice"]
---

# Get all invoices on a workspace

`GET /v1/workspaces/{workspaceId}/invoices`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.

## Query parameters

- `page` integer — Page number.
- `page-size` integer — Page size.
- `statuses` 'UNSENT' | 'SENT' | 'PAID' | 'PARTIALLY_PAID' | 'VOID' | 'OVERDUE'
- `sort-column` 'ID' | 'CLIENT' | 'DUE_ON' | 'ISSUE_DATE' | 'AMOUNT' | 'BALANCE'
- `sort-order` 'ASCENDING' | 'DESCENDING'

## Response `200`

OK

- InvoicesListDtoV1
  - `invoices` InvoiceDtoV1[] — Represents a list of invoices.
    - `amount` integer — Represents an invoice amount as long.
    - `balance` integer — Represents an invoice balance amount as long.
    - `clientId` string — Represents client identifier across the system.
    - `clientName` string — Represents client name for an invoice.
    - `currency` string — Represents the currency used by the invoice.
    - `dueDate` string, date-time — Represents an invoice due date in yyyy-MM-ddThh:mm:ssZ format.
    - `id` string — Represents invoice identifier across the system.
    - `issuedDate` string, date-time — Represents an invoice issued date in yyyy-MM-ddThh:mm:ssZ format.
    - `number` string — Represents an invoice number.
    - `paid` integer — Represents an invoice paid amount as long.
    - `status` 'UNSENT' | 'SENT' | 'PAID' | 'PARTIALLY_PAID' | 'VOID' | 'OVERDUE' — Represents the status of an invoice.
  - `total` integer — Represents the total invoice count.

## Changes

- **2026-08-20** `a5b636acbcd8` — 6 info
  - the `clientId` response's property default value `` was added for the status `200`
  - the `clientName` response's property default value `` was added for the status `200`
  - the `currency` response's property default value `` was added for the status `200`
  - the `id` response's property default value `` was added for the status `200`
  - …2 more

[Change history](https://skmtc.dev/clockify/apis/clockify-api/changes/v1/workspaces/:workspaceId/invoices/get.md)

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)