---
title: "List All Invoices"
method: GET
path: "/v2/customers/my/invoices"
tags: ["DigitalOcean-public.v2-new_Billing"]
---

# List All Invoices

`GET /v2/customers/my/invoices`

To retrieve a list of all invoices, send a GET request to `/v2/customers/my/invoices`.

## Query parameters

- `per_page` integer
- `page` integer

## Response `200`

The response will be a JSON object contains that contains a list of invoices under the `invoices` key, and the invoice preview under the `invoice_preview` key.
Each element contains the invoice summary attributes.

- object
  - `invoices` InvoicePreview[]
    - `invoice_uuid` string — The UUID of the invoice. The canonical reference for the invoice.
    - `invoice_id` string — ID of the invoice. Listed on the face of the invoice PDF as the "Invoice number".
    - `amount` string — Total amount of the invoice, in USD. This will reflect month-to-date usage in the invoice preview.
    - `invoice_period` string — Billing period of usage for which the invoice is issued, in `YYYY-MM` format.
    - `updated_at` string — Time the invoice was last updated. This is only included with the invoice preview.
  - `invoice_preview` InvoicePreview — The invoice preview.
    - `invoice_uuid` string — The UUID of the invoice. The canonical reference for the invoice.
    - `invoice_id` string — ID of the invoice. Listed on the face of the invoice PDF as the "Invoice number".
    - `amount` string — Total amount of the invoice, in USD. This will reflect month-to-date usage in the invoice preview.
    - `invoice_period` string — Billing period of usage for which the invoice is issued, in `YYYY-MM` format.
    - `updated_at` string — Time the invoice was last updated. This is only included with the invoice preview.
  - `links` PageLinks
    - `pages` union
      - ForwardLinks
        - `last` string — URI of the last page of the results.
        - `next` string — URI of the next page of the results.
      - BackwardLinks
        - `first` string — URI of the first page of the results.
        - `prev` string — URI of the previous page of the results.
      - unknown
  - `meta` object, required — Information about the response itself.
    - `total` integer, required — Number of objects returned by the request.

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

---

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