---
title: pydo.invoices
description: |
    The billing endpoints allow you to retrieve your account balance, invoices, billing history, and insights.
product: Reference
url: https://docs.digitalocean.com/reference/pydo/reference/invoices/
last_updated: "2026-08-03"
---

> **For AI agents:** The documentation index is at [https://docs.digitalocean.com/llms.txt](https://docs.digitalocean.com/llms.txt). Markdown versions of pages use the same URL with `index.html.md` in place of the HTML page (for example, append `index.html.md` to the directory path instead of opening the HTML document).

# pydo.invoices

Generated on 3 Aug 2026 from `pydo` version [`v0.40.0`](https://github.com/digitalocean/pydo/releases/tag/v0.40.0v0.40.0)

The billing endpoints allow you to retrieve your account balance, invoices, billing history, and insights.

**Balance:** By sending requests to the [`/v2/customers/my/balance`](https://docs.digitalocean.com/reference/api/reference/billing/index.html.md#balance_get) endpoint, you can retrieve the balance information for the requested customer account.

**Invoices:** [Invoices](https://docs.digitalocean.com/platform/billing/invoices/index.html.md) are generated on the first of each month for every DigitalOcean customer. An invoice preview is generated daily, which can be accessed with the `preview` keyword in place of `$INVOICE_UUID`. To interact with invoices, you will generally send requests to the invoices endpoint at [`/v2/customers/my/invoices`](https://docs.digitalocean.com/reference/api/reference/billing/index.html.md#invoices_list).

**Billing History:** Billing history is a record of billing events for your account. For example, entries may include events like payments made, invoices issued, or credits granted. To interact with invoices, you will generally send requests to the invoices endpoint at [`/v2/customers/my/billing_history`](https://docs.digitalocean.com/reference/api/reference/billing/index.html.md#billingHistory_list).

**Billing Insights:** 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 items do not necessarily encompass all invoicing factors for the entire month. `v2/billing/{account_urn}/insights/{start_date}/{end_date}` where account_urn is the URN of the customer account, can be a team (do:team:uuid) or an organization (do:teamgroup:uuid). The date range specified by start_date and end_date must be in YYYY-MM-DD format.

[pydo.invoices.get_by_uuid()](https://docs.digitalocean.com/reference/pydo/reference/invoices/get_by_uuid/index.html.md): Retrieve an Invoice by UUID

[pydo.invoices.get_csv_by_uuid()](https://docs.digitalocean.com/reference/pydo/reference/invoices/get_csv_by_uuid/index.html.md): Retrieve an Invoice CSV by UUID

[pydo.invoices.get_pdf_by_uuid()](https://docs.digitalocean.com/reference/pydo/reference/invoices/get_pdf_by_uuid/index.html.md): Retrieve an Invoice PDF by UUID

[pydo.invoices.get_summary_by_uuid()](https://docs.digitalocean.com/reference/pydo/reference/invoices/get_summary_by_uuid/index.html.md): Retrieve an Invoice Summary by UUID

[pydo.invoices.list()](https://docs.digitalocean.com/reference/pydo/reference/invoices/list/index.html.md): List All Invoices