billing

List billing charges

Lists the billing charges for the account.

get/{account}/billing/charges

Path parameters

accountinteger required

The account id

Query parameters

start_datestring date

A date value formatted as ISO 8601.

Example:2010-01-01

Only include results after the given date. Format is ISO8601 (YYYY-MM-DD).

end_datestring date

A date value formatted as ISO 8601.

Example:2010-01-01

Only include results before the given date. Format is ISO8601 (YYYY-MM-DD).

sort'invoiced:asc' | 'invoiced:desc'

Sort results. Default sorting is by invoiced ascending.

Response

Billing charges listing.

Example response

{
  "data": [
    {
      "invoiced_at": "2017-03-03T13:49:58.000Z",
      "total_amount": "50.00",
      "balance_amount": "50.00",
      "reference": "20170303-0001",
      "state": "collected",
      "items": [
        {
          "description": "Auto Renew example.com",
          "amount": "50.00",
          "product_id": 153,
          "product_type": "domain-renewal",
          "product_reference": "example.com"
        }
      ]
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 30,
    "total_entries": 2,
    "total_pages": 1
  }
}

Changes

Changed in 3 of the 52 revisions of this API.120

Jul 11, 2025v206780be0ef1719See the full diff
- ○
  the response property data became required for the status 200
  response-property-became-required
- ○
  the response property data/items/balance_amount became required for the status 200
  response-property-became-required
- ○
  the response property data/items/invoiced_at became required for the status 200
  response-property-became-required
- ○
  the response property data/items/items became required for the status 200
  response-property-became-required
- ○
  the response property data/items/items/items/amount became required for the status 200
  response-property-became-required
- ○
  the response property data/items/items/items/description became required for the status 200
  response-property-became-required
- ○
  the response property data/items/items/items/product_id became required for the status 200
  response-property-became-required
- ○
  the response property data/items/items/items/product_reference became required for the status 200
  response-property-became-required
- ○
  the response property data/items/items/items/product_type became required for the status 200
  response-property-became-required
- ○
  the response property data/items/reference became required for the status 200
  response-property-became-required
- ○
  the response property data/items/state became required for the status 200
  response-property-became-required
- ○
  the response property data/items/total_amount became required for the status 200
  response-property-became-required
- ○
  the response property message became required for the status 401
  response-property-became-required
- ○
  the response property message became required for the status 429
  response-property-became-required
- ○
  the response property pagination became required for the status 200
  response-property-became-required
- ○
  the response property pagination/current_page became required for the status 200
  response-property-became-required
- ○
  the response property pagination/per_page became required for the status 200
  response-property-became-required
- ○
  the response property pagination/total_entries became required for the status 200
  response-property-became-required
- ○
  the response property pagination/total_pages became required for the status 200
  response-property-became-required
Nov 1, 2023v209b1844407a31See the full diff
- ○
  endpoint added
  endpoint-added
Jul 18, 2023v2c8591dcf8c291See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 25 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history