---
title: "Retrieve an Invoice Summary by UUID"
method: GET
path: "/v2/customers/my/invoices/{invoice_uuid}/summary"
tags: ["DigitalOcean-public.v2-new_Billing"]
---

# Retrieve an Invoice Summary by UUID

`GET /v2/customers/my/invoices/{invoice_uuid}/summary`

To retrieve a summary for an invoice, send a GET request to `/v2/customers/my/invoices/$INVOICE_UUID/summary`.

## Path parameters

- `invoice_uuid` string, required

## Response `200`

To retrieve a summary for an invoice, send a GET request to  `/v2/customers/my/invoices/$INVOICE_UUID/summary`.

- InvoiceSummary
  - `invoice_uuid` string — UUID of the invoice
  - `invoice_id` string — ID of the invoice
  - `billing_period` string — Billing period of usage for which the invoice is issued, in `YYYY-MM` format.
  - `amount` string — Total amount of the invoice, in USD. This will reflect month-to-date usage in the invoice preview.
  - `user_name` string — Name of the DigitalOcean customer being invoiced.
  - `user_billing_address` object — The billing address of the customer being invoiced.
    - `address_line1` string — Street address line 1
    - `address_line2` string — Street address line 2
    - `city` string — City
    - `region` string — Region
    - `postal_code` string — Postal code
    - `country_iso2_code` string — Country (ISO2) code
    - `created_at` string — Timestamp billing address was created
    - `updated_at` string — Timestamp billing address was updated
  - `user_company` string — Company of the DigitalOcean customer being invoiced, if set.
  - `user_email` string — Email of the DigitalOcean customer being invoiced.
  - `product_charges` object — A summary of the product usage charges contributing to the invoice. This will include an amount, and grouped aggregates by resource type under the `items` key.
    - `name` string — Description of usage charges
    - `amount` string — Total amount charged
    - `items` ProductChargeItem[] — List of amount, and grouped aggregates by resource type.
      - `amount` string — Amount of the charge
      - `name` string — Description of the charge
      - `count` string — Number of times the charge was applied
  - `overages` object — A summary of the overages contributing to the invoice.
    - `name` string — Name of the charge
    - `amount` string — Total amount charged in USD
  - `taxes` object — A summary of the taxes contributing to the invoice.
    - `name` string — Name of the charge
    - `amount` string — Total amount charged in USD
  - `credits_and_adjustments` object — A summary of the credits and adjustments contributing to the invoice.
    - `name` string — Name of the charge
    - `amount` string — Total amount charged in USD

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `404` — The resource was not found.
- `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/revisions/cb3bf9b21459/schema)