---
title: "Get list of billing statements"
method: GET
path: "/v3/organizations/{organizationId}/billing-statements"
tags: ["organizations"]
---

# Get list of billing statements

`GET /v3/organizations/{organizationId}/billing-statements`

Get a list of billing statements for the organization. BILL generates a monthly billing invoice statement for all the billing activities in the organization.

In the request, set `invoiceDateFrom` and `invoiceDateTo` to get the billing invoice statements for the specified date range.

You can set `max` and `page` in the request only when both `invoiceDateFrom` and `invoiceDateTo` are not set. By default, you get 20 results on one page of results. Set `max` in your request to get up to 100 results on one page.

See [Search operations with lists](https://developer.bill.com/docs/search-op-with-lists) in the Guides section for filtering, sorting, and pagination examples.

## Path parameters

- `organizationId` string, required — BILL-generated ID of the organization. The value begins with `008`.

## Query parameters

- `max` integer, nullable — Maximum number of results. You can set `max` only when both `invoiceDateFrom` and `invoiceDateTo` are not set.
- `invoiceDateFrom` string, nullable — Billing invoice start date. The value is in the `yyyy-MM-dd` format. This field is required if `invoiceDateTo` is set.
- `invoiceDateTo` string, nullable — Billing invoice end date. The value is in the `yyyy-MM-dd` format. This field is required if `invoiceDateFrom` is set.
- `page` string, nullable — Next page of results. You can set `page` only when both `invoiceDateFrom` and `invoiceDateTo` are not set. When a list has multiple pages, the `nextPage` and `prevPage` values in the response enable you to navigate between the pages of results. Set `page` as the `nextPage` or `prevPage` value for navigation.

## Headers

- `sessionId` string, nullable — API session ID generated with `/v3/login`
- `devKey` string, nullable — Developer key generated with your BILL developer account

## Response `200`

Get list of billing statements response

- ListBillingStatementResponseDto — Response from a list API request with paging references.
  - `nextPage` string
  - `prevPage` string
  - `results` BillingStatementResponseDto[]
    - `id` string, required — BILL-generated ID of the billing statement. The value begins with `0S0`.
    - `invoiceNumber` string, required — Billing invoice number
    - `invoiceDate` string, date, required — Billing invoice date
    - `description` string, required — Billing invoice description
    - `billingPeriod` object, required — Billing period information
      - `startDate` string, date — Billing period start date
      - `endDate` string, date — Billing period end date
    - `paymentStatus` 'UNPAID' | 'PAID' | 'PENDING' | 'FAILED' | 'VOIDED' | 'UNDEFINED', required — Billing invoice payment status
    - `paymentDate` string, date — Billing invoice payment date
    - `amount` number, required — Billing invoice amount

## Other responses

- `4XX` — List of errors.
- `5XX` — List of errors.

---

[API](https://skmtc.net/bill/apis/bill-v3-api.md) · [All operations](https://skmtc.net/bill/apis/bill-v3-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bill/bill-v3-api/versions/0483350c434e/schema)