---
title: "List billing charges"
method: GET
path: "/{account}/billing/charges"
tags: ["billing"]
---

# List billing charges

`GET /{account}/billing/charges`

Lists the billing charges for the account.

## Path parameters

- `account` integer, required

## Query parameters

- `start_date` string, date — A date value formatted as ISO 8601.
- `end_date` string, date — A date value formatted as ISO 8601.
- `sort` 'invoiced:asc' | 'invoiced:desc'

## Response `200`

Billing charges listing.

- object
  - `data` Charge[], required
    - `invoiced_at` string, date-time, required — A date-time value formatted as ISO 8601.
    - `total_amount` string, required — The aggregate amount of all line items, that need to be paid.
    - `balance_amount` string, required — The amount that was paid via wallet.
    - `reference` string, required — The reference number of the invoice.
    - `state` 'collected' | 'refunded', required
    - `items` ChargeItem[], required
      - `description` string, required
      - `amount` string, required
      - `product_id` integer, nullable, required — The ID of the product that was charged. Null when the product type is "manual".
      - `product_type` string, required — The type of the product that was charged.
      - `product_reference` string, nullable, required — A unique or representative reference. For example, the domain name that was charged. Or the ID of the subscription or the order ID of the product. Null when the product type is "manual"
  - `pagination` Pagination, required
    - `current_page` integer, required
    - `per_page` integer, required
    - `total_entries` integer, required
    - `total_pages` integer, required

## Other responses

- `401` — The authentication credentials are invalid.
- `429` — You exceeded the allowed number of requests per hour and your request has temporarily been throttled.

---

[API](https://skmtc.net/dnsimple/apis/dnsimple-api.md) · [All operations](https://skmtc.net/dnsimple/apis/dnsimple-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dnsimple/dnsimple-api/revisions/270bb4f6f532/schema)