---
title: "List billing documents for an account"
method: GET
path: "/v1/billing-documents"
tags: ["Billing Documents"]
---

# List billing documents for an account

`GET /v1/billing-documents`

Retrieves the information about all billing documents associated with a specified account. The billing documents contain invoices, credit memos, and debit memos.

To retrieve information about credit memos and debit memos, you must have the Invoice Settlement feature enabled. 

You can use query parameters to restrict the data returned in the response.

Examples:
- /billing-documents?accountId=4028905f5e4feb38015e50af9aa002d1&sort=+documentDate
- /billing-documents?accountId=4028905f5e4feb38015e50af9aa002d1&status=Posted
- /billing-documents?accountNumber=A00000001&sort=+documentDate
- /billing-documents?accountNumber=A00000001&status=Posted

## Query parameters

- `page` integer
- `pageSize` integer
- `accountId` string, uuid
- `accountNumber` string, uuid
- `documentDate` string, date
- `status` 'Draft' | 'Posted' | 'Canceled' | 'Error'
- `sort` string

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- BillingDocumentQueryResponseElementType
  - `documents` GETBillingDocumentsResponseType[] — Container for billing documents.
    - `accountId` string, uuid — The ID of the customer account associated with the billing document.
    - `amount` number, double — The total amount of the billing document.
    - `balance` number, double — The balance of the billing document.
    - `documentDate` string, date — The date of the billing document. The date can be the invoice date for invoices, credit memo date for credit memos, or debit memo date for debit memos.
    - `documentNumber` string — The number of the billing document.
    - `documentType` 'Invoice' | 'CreditMemo' | 'DebitMemo' — The type of the billing document.
    - `id` string — The ID of the billing document.
    - `status` 'Draft' | 'Posted' | 'Canceled' | 'Error' — The current status of the billing document.
    - `currency` string, nullable — The currency of the billing document. **Note:** By default, the currency on a billing document matches the default currency set on the associated account. However, Zuora now offers a Multiple Currencies feature to support different currencies for billing documents, allowing flexibility beyond the account-level currency. For more information, see <a href="https://docs.zuora.com?resourceId=billing-multiple-currencies-overview" target="_blank">Multiple Currency</a>.
  - `nextPage` string, URL — URL to retrieve the next page of the response if it exists; otherwise absent.
  - `success` boolean — Returns `true` if the request was processed successfully.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

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