---
title: "Returns a list of all the invoices for the given customer"
method: GET
path: "/v1/customer/{customerId}/invoices"
tags: ["customer"]
---

# Returns a list of all the invoices for the given customer

`GET /v1/customer/{customerId}/invoices`

## Path parameters

- `customerId` string, required

## Response `200`

successful operation

- InvoiceResponse
  - `invoices` Invoice[], required
    - `number` string, required — a unique identifying string for invoices
    - `amount` number, required — current final amount due for the invoices
    - `hostedInvoiceUrl` string — URL for the hosted invoice page, which allows customers to view and pay an invoice
    - `invoicePdf` string — the link to download the PDF for the invoice
    - `status` 'PAID' | 'UNPAID' | 'VOID', required — one of PAID, UNPAID, or VOID
    - `createAt` string, required — created timestamp

## Other responses

- `400` — bad request
- `404` — not found

---

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