---
title: "Get workspace invoices."
method: GET
path: "/workspaces/{workspace_id}/invoices"
tags: ["user-invoices"]
---

# Get workspace invoices.

`GET /workspaces/{workspace_id}/invoices`

## Request

- Base URL: `https://localhost:8080/api/v9`
- URL: `https://localhost:8080/api/v9/workspaces/{workspace_id}/invoices`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/toggl/apis/toggl-api/docs/workspaces/:workspace_id/invoices/get.ts> (a function with typed inputs; its response is checked against the schema)

Get invoices for given workspace with pagination.

## Request body `application/x-www-form-urlencoded`

- object
  - `sort_order` string: Sort order, default ASC.
  - `per_page` integer: Number of items per page, default 50.
  - `page` integer: Page number, default 1.
  - `sort_field` string: Sort field, default created_at.

## Response `200`

Successful operation

- ModelsUserInvoice[]
  - `billing_address` string
  - `created_at` string
  - `currency` string
  - `date` string
  - `deleted_at` string
  - `document_id` string
  - `due_date` string
  - `items` ModelsUserInvoiceItem[]
    - `amount` number
    - `description` string
    - `item_id` integer
    - `quantity` number
  - `message` string
  - `payment_terms` string
  - `purchase_number` string
  - `taxes` ModelsUserInvoiceTax[]
    - `amount` number
    - `name` string
    - `tax_id` integer
  - `updated_at` string
  - `user_id` integer
  - `user_invoice_id` integer
  - `workspace_address` string
  - `workspace_id` integer
  - `workspace_logo` string

## Other responses

- `403`: Operation Forbidden
- `500`: Internal Server Error

---

[API](https://skmtc.dev/toggl/apis/toggl-api.md) - [All operations](https://skmtc.dev/toggl/apis/toggl-api/llms.txt) - [OpenAPI document](https://skmtc.dev/toggl/apis/toggl-api/revisions/3085aee16990?raw)