---
title: "List invoices for the authenticated customer"
method: GET
path: "/customer-invoices"
tags: ["Customer Order"]
---

# List invoices for the authenticated customer

`GET /customer-invoices`

## Request

- Base URL: `http://localhost:8000/api/shop`
- URL: `http://localhost:8000/api/shop/customer-invoices`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/bagisto/apis/bagisto-shop-api/docs/customer-invoices/get.ts> (a function with typed inputs; its response is checked against the schema)

Mirrors the GraphQL `customerInvoices(orderId:)` query. Use `?order_id=N` to scope to a specific order, `?state=paid` (or pending, pending_payment, overdue, refunded) to filter by invoice state.

## Query parameters

- `order_id` integer
- `state` string
- `page` integer
- `per_page` integer

## Headers

- `X-STOREFRONT-KEY` string, required
- `X-Locale` string
- `X-Channel` string
- `X-Currency` string

## Response `200`

CustomerInvoice collection

- CustomerInvoice[]
  - `id` integer
  - `incrementId` string, nullable
  - `state` string, nullable
  - `emailSent` boolean
  - `totalQty` integer, nullable
  - `baseCurrencyCode` string, nullable
  - `channelCurrencyCode` string, nullable
  - `orderCurrencyCode` string, nullable
  - `subTotal` number, nullable
  - `baseSubTotal` number, nullable
  - `grandTotal` number, nullable
  - `baseGrandTotal` number, nullable
  - `shippingAmount` number, nullable
  - `baseShippingAmount` number, nullable
  - `taxAmount` number, nullable
  - `baseTaxAmount` number, nullable
  - `discountAmount` number, nullable
  - `baseDiscountAmount` number, nullable
  - `shippingTaxAmount` number
  - `baseShippingTaxAmount` number
  - `subTotalInclTax` number
  - `baseSubTotalInclTax` number
  - `shippingAmountInclTax` number
  - `baseShippingAmountInclTax` number
  - `transactionId` string, nullable
  - `reminders` integer
  - `nextReminderAt` string, date-time, nullable
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable
  - `downloadUrl` string
  - `items` string[]
  - `addresses` string[]

---

[API](https://skmtc.dev/bagisto/apis/bagisto-shop-api.md) - [All operations](https://skmtc.dev/bagisto/apis/bagisto-shop-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bagisto/apis/bagisto-shop-api/revisions/f619df36bf29?raw)