---
title: "List billing statements for an organization"
method: GET
path: "/organizations/{orgId}/statements"
tags: ["Organizations"]
---

# List billing statements for an organization

`GET /organizations/{orgId}/statements`

## Request

- Base URL: `https://dashboard.hologram.io/api/1`
- URL: `https://dashboard.hologram.io/api/1/organizations/{orgId}/statements`
- Auth: HTTP basic
- TypeScript: <https://skmtc.dev/hologram/apis/hologram-rest-api-v1/docs/organizations/:orgId/statements/get.ts> (a function with typed inputs; its response is checked against the schema)

Get billing statement records that match the passed in parameters

## Path parameters

- `orgId` integer, required

## Query parameters

- `id` integer
- `report_start_date` string, date
- `startafter` integer
- `limit` integer

## Response `200`

OK

- ListBillingStatementsResponse
  - `success` boolean: Indicates whether the request was successful.
  - `data` BillingStatement[]
    - `id` integer
    - `orgid` integer
    - `net_total` string: Net total amount for the billing period
    - `debit_total` string: Total debits for the billing period
    - `credit_total` string: Total credits for the billing period
    - `report_start_date` string, date: Start date of the billing period
    - `whencreated` string, date-time: When the statement record was created
  - `limit` integer
  - `size` integer
  - `continues` boolean
  - `lastid` integer: ID of the last record returned, for cursor-based pagination
  - `links` PaginationLinks
    - `path` string: The API endpoint path
    - `base` string: The API base URL
    - `next` string: URL to retrieve the next page of results

## Other responses

- `400`: No permission to access billing on this organization
- `401`: Unauthorized

---

[API](https://skmtc.dev/hologram/apis/hologram-rest-api-v1.md) - [All operations](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/hologram/apis/hologram-rest-api-v1/revisions/1bc07dcd1631?raw)
