---
title: "List All Invoices"
method: GET
path: "/billing/v1/invoices"
tags: ["Invoice"]
---

# List All Invoices

`GET /billing/v1/invoices`

## Request

- Base URL: `https://marketplace.appdirect.com/api`
- URL: `https://marketplace.appdirect.com/api/billing/v1/invoices`
- Auth: none declared
- TypeScript: <https://skmtc.dev/appdirect/apis/companies/docs/billing/v1/invoices/get.ts> (a function with typed inputs; its response is checked against the schema)

List all invoice data

## Query parameters

- `count` string
- `excludeFree` boolean
- `fromDate` number
- `sortField` 'DATE' | 'INVOICE_ID' | 'TOTAL'
- `sortOrder` 'ASC' | 'DESC'
- `start` string
- `status` 'CARRIED' | 'PAID' | 'UNPAID' | 'VOIDED'
- `toDate` number
- `buyerRole` 'ALL' | 'CUSTOMER' | 'RESELLER' | 'SALES_SUPPORT'

## Response `200`

OK

- InvoiceListingWS[]: OK
  - `links` Link[]: Resource links
    - `href` string
    - `rel` string
  - `company` LinkWS, nullable
    - `href` string
    - `id` string
  - `creationDate` number, nullable: Creation date for the invoice.
  - `orderIds` string[]: Array of Order IDs
  - `currency` 'USD' | 'CAD' | 'EUR' | 'JPY' | 'GBP' | 'KRW' | 'CHF' | 'SEK' | 'SGD' | 'MYR' | 'AUD' | 'MXN' | 'INR' | 'BRL' | 'DKK' | 'NZD' | 'NOK' | 'ZAR' | 'PHP' | 'CNY' | 'SAR' | 'GTQ' | 'IDR' | 'ARS' | 'COP' | 'PEN': Supported currencies for the system
  - `dueDate` number, nullable: Due date for the invoice.
  - `invoiceId` number, nullable: Invoice ID.
  - `referenceNumber` string, nullable: Reference number.
  - `status` 'PAID' | 'UNPAID' | 'CARRIED' | 'VOIDED'
  - `total` number, nullable: Invoice total.
  - `user` LinkWS, nullable
    - `href` string
    - `id` string

## Other responses

- `204`: No Content
- `401`: Unauthorized
- `404`: Not Found

## Changes

- **2026-11-06** `1fc240f06971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/billing/v1/invoices/get.md)

---

[API](https://skmtc.dev/appdirect/apis/companies.md) - [All operations](https://skmtc.dev/appdirect/apis/companies/llms.txt) - [OpenAPI document](https://skmtc.dev/appdirect/apis/companies/revisions/1fc240f06971?raw)