---
title: "Get billing statement details"
method: GET
path: "/v3/organizations/{organizationId}/billing-statements/{billingStatementId}"
tags: ["organizations"]
---

# Get billing statement details

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

## Request

- Base URL: `https://gateway.stage.bill.com/connect`
- URL: `https://gateway.stage.bill.com/connect/v3/organizations/{organizationId}/billing-statements/{billingStatementId}`
- Auth: none declared

Get details about a billing statement for the organization. BILL generates a monthly billing invoice statement for all the billing activities in the organization.

From the response, use `downloadLink` in a GET request to download a billing statement.

```
curl '{downloadLink}' --header 'sessionId: {session_id}' --output {statement_name}
```

## Path parameters

- `organizationId` string, required: BILL-generated ID of the organization. The value begins with `008`.
- `billingStatementId` string, required: BILL-generated ID of the billing statement. The value begins with `0S0`.

## 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 billing statement details response

- BillingStatementDetailResponseDto: BillingStatementDetail response Dto.
  - `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
  - `statementDetails` BillingStatementDetailLineItemDto[]: Statement details. This includes billing invoice line item information.
    - `quantity` integer: Billing invoice line item quantity
    - `description` string: Billing invoice line item description
    - `type` string: Billing invoice line item type
    - `amount` number: Billing invoice line item amount
  - `downloadLink` object, required: Billing statement download link information
    - `csv` string, required: CSV format
    - `pdf` string, required: PDF format

## Other responses

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

## Changes

- **2026-11-03** `54edddceb0a5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bill/apis/bill-v3-api/changes/v3/organizations/:organizationId/billing-statements/:billingStatementId/get.md)

---

[API](https://skmtc.dev/bill/apis/bill-v3-api.md) - [All operations](https://skmtc.dev/bill/apis/bill-v3-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bill/apis/bill-v3-api/revisions/54edddceb0a5?raw)