---
title: "List all invoices for a subscription"
method: GET
path: "/billing/v1/subscriptions/{subscriptionId}/invoices"
tags: ["Subscriptions"]
---

# List all invoices for a subscription

`GET /billing/v1/subscriptions/{subscriptionId}/invoices`

## Request

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

List all of the invoices for the given subscription

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `count` integer
- `excludeFree` boolean
- `fromDate` number
- `sortField` 'DATE' | 'INVOICE_ID' | 'TOTAL'
- `sortOrder` 'ASC' | 'DESC'
- `start` integer
- `status` 'CARRIED' | 'PAID' | 'UNPAID' | 'VOIDED'
- `toDate` number

## 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

- `404`: Not Found

## Changes

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

[Operation history](https://skmtc.dev/appdirect/apis/companies/changes/billing/v1/subscriptions/:subscriptionId/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)