pydo.billing_insights.list()
Generated on 17 Dec 2025
from pydo version
v0.23.0
Description
This endpoint returns day-over-day changes in billing resource usage based on nightly invoice items, including total amount, region, SKU, and description for a specified date range. It is important to note that the daily resource usage may not reflect month-end billing totals when totaled for a given month as nightly invoice item estimates do not necessarily encompass all invoicing factors for the entire month.
Parameters
| Name | Type | Required | Description | Default Value |
|---|---|---|---|---|
account_urn |
string | True | URN of the customer account, can be a team (do:team:uuid) or an organization (do:teamgroup:uuid) | |
start_date |
string | True | Start date for billing insights in YYYY-MM-DD format | |
end_date |
string | True | End date for billing insights in YYYY-MM-DD format. Must be within 31 days of start_date | |
per_page |
integer | False | Number of items returned per page | 20 |
page |
integer | False | Which ‘page’ of paginated results to return. | 1 |
Request Sample
import os
from pydo import Client
client = Client(token=os.environ.get("DIGITALOCEAN_TOKEN"))
insights = client.billing.list_insights(
account_urn="do:team:12345678-1234-1234-1234-123456789012",
start_date="2025-01-01",
end_date="2025-01-31",
per_page=100,
page=1
)More Information
See the API spec for this endpoint to view additional detail on responses, headers, parameters, and more.