---
title: "List organization client invoices"
method: GET
path: "/v2/organizations/{organization_id}/client_invoices"
tags: ["client_invoices"]
---

# List organization client invoices

`GET /v2/organizations/{organization_id}/client_invoices`

## Request

- Base URL: `https://api.hubstaff.com`
- URL: `https://api.hubstaff.com/v2/organizations/{organization_id}/client_invoices`
- Auth: OAuth 2
  - Authorization code: `https://account.hubstaff.com/authorizations/new`
  - Token URL: `https://account.hubstaff.com/access_tokens` scopes: `hubstaff:read`, `hubstaff:write`
- TypeScript: <https://skmtc.dev/hubstaff/apis/hubstaff-v2-api/docs/v2/organizations/:organization_id/client_invoices/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns invoices sent to clients for the given organization.

Results can be filtered by client_ids[], issue_date[start]/[stop], and status. Use include_line_items=true to include invoice line items.

## Path parameters

- `organization_id` integer, required

## Query parameters

- `page_start_id` integer
- `page_limit` integer
- `client_ids` integer[]
- `issue_date[start]` string, date
- `issue_date[stop]` string, date
- `status` 'draft' | 'open' | 'closed'
- `include_line_items` boolean
- `include` string[]

## Response `200`

A list of client invoices

- object
  - `client_invoices` ClientInvoice[]
    - `organization_id` integer, required: Organization ID
    - `status` string, required: Invoice status
    - `author_id` integer, required: The user who created the invoice
    - `number` string, required: Invoice number
    - `po_number` string, required: Invoice PO number
    - `notes` string, required: Invoice notes
    - `currency` string, required: Invoice currency
    - `grand_total` number, float, required: Grand total
    - `paid_amount` number, float, required: Amount paid
    - `tax_1` number, float: Tax 1 percentage to apply to sub total for enabled line items
    - `tax_2` number, float: Tax 2 percentage to apply to sub total for enabled line items
    - `discount` number, float: Discount percentage to apply to before taxes for enabled line items
    - `issue_date` string, date, required: Invoice issue date
    - `due_date` string, date: Invoice due date
    - `created_at` string, date-time, required: When the record was created
    - `updated_at` string, date-time, required: When the record was last updated
    - `line_items` InvoiceLineItem[]: List of invoice line items
      - `id` integer, required: Invoice item id
      - `created_at` string, date-time, required: When the record was created
      - `updated_at` string, date-time, required: When the record was last updated
      - `description` string, required: Item description
      - `quantity` number, float, required: Item quantity
      - `unit_price` number, float, required: Item price
      - `generated` boolean: True if this line item was generated
      - `generated_data` object
        - `duration` integer: Time worked in seconds for generated data
        - `rates` number[]: Hourly rates used for generated data
        - `grouping` string: The grouping mode used for the generated data
        - `user_ids` integer[]: User ids included in generated data
        - `project_ids` integer[]: Project ids included in generated data
        - `task_ids` integer[]: Tasks ids included in generated data (Client invoices only)
        - `start_date` string, date: The start date for the time include in the generated data
        - `stop_date` string, date: The stop date for the time include in the generated data
      - `tax_1` boolean, required: Item tax 1
      - `tax_2` boolean, required: Item tax 2
      - `discount` boolean, required: Item discount
    - `viewer_url` string, uri, required: View only URL
    - `id` integer, required: Client invoice ID
    - `client_id` integer, required: Client ID this invoice is for

## Other responses

- `400`: Invalid parameters
- `401`: Unauthorized
- `403`: API access is only for organizations on an active plan
- `404`: Could not find record
- `429`: Rate limit exceeded

## Changes

- **2026-11-06** `c6b90e4e4bdc`: 1 info
  - added the new optional `query` request parameter `include`

[Operation history](https://skmtc.dev/hubstaff/apis/hubstaff-v2-api/changes/v2/organizations/:organization_id/client_invoices/get.md)

---

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