---
title: "List invoices (datagrid parity)"
method: GET
path: "/invoices"
tags: ["Admin Sales: Invoices"]
---

# List invoices (datagrid parity)

`GET /invoices`

## Request

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

Paginated invoices listing. Every invoice column + billing/shipping addresses are populated per row (line items are detail-only). Returns a `{ data, meta }` envelope. Requires `sales.invoices.view`.

## Query parameters

- `page` integer
- `per_page` integer
- `id` string
- `customer_id` integer
- `order_id` string
- `state` 'pending' | 'pending_payment' | 'paid' | 'overdue'
- `base_grand_total_from` number
- `base_grand_total_to` number
- `created_at_from` string, date
- `created_at_to` string, date
- `sort` 'id' | 'increment_id' | 'order_id' | 'base_grand_total' | 'state' | 'created_at'
- `order` 'asc' | 'desc'

## Response `200`

AdminInvoice collection

- AdminInvoiceAdminInvoiceRestDto[]
  - `id` integer, nullable
  - `incrementId` string, nullable
  - `orderId` integer, nullable
  - `orderIncrementId` string, nullable
  - `state` string, nullable
  - `emailSent` boolean, nullable
  - `totalQty` integer, nullable
  - `orderCurrencyCode` string, nullable
  - `baseCurrencyCode` string, nullable
  - `channelCurrencyCode` string, nullable
  - `subTotal` number, nullable
  - `formattedSubTotal` string, nullable
  - `baseSubTotal` number, nullable
  - `formattedBaseSubTotal` string, nullable
  - `subTotalInclTax` number, nullable
  - `formattedSubTotalInclTax` string, nullable
  - `baseSubTotalInclTax` number, nullable
  - `formattedBaseSubTotalInclTax` string, nullable
  - `grandTotal` number, nullable
  - `formattedGrandTotal` string, nullable
  - `baseGrandTotal` number, nullable
  - `formattedBaseGrandTotal` string, nullable
  - `taxAmount` number, nullable
  - `formattedTaxAmount` string, nullable
  - `baseTaxAmount` number, nullable
  - `formattedBaseTaxAmount` string, nullable
  - `discountAmount` number, nullable
  - `formattedDiscountAmount` string, nullable
  - `baseDiscountAmount` number, nullable
  - `formattedBaseDiscountAmount` string, nullable
  - `shippingAmount` number, nullable
  - `formattedShippingAmount` string, nullable
  - `baseShippingAmount` number, nullable
  - `formattedBaseShippingAmount` string, nullable
  - `shippingAmountInclTax` number, nullable
  - `formattedShippingAmountInclTax` string, nullable
  - `baseShippingAmountInclTax` number, nullable
  - `formattedBaseShippingAmountInclTax` string, nullable
  - `shippingTaxAmount` number, nullable
  - `formattedShippingTaxAmount` string, nullable
  - `baseShippingTaxAmount` number, nullable
  - `formattedBaseShippingTaxAmount` string, nullable
  - `transactionId` string, nullable
  - `reminders` integer, nullable
  - `nextReminderAt` string, nullable
  - `createdAt` string, nullable
  - `updatedAt` string, nullable
  - `orderStatus` string, nullable
  - `orderStatusLabel` string, nullable
  - `orderDate` string, nullable
  - `channelName` string, nullable
  - `customerName` string, nullable
  - `customerEmail` string, nullable
  - `order` unknown[], nullable
    - unknown
  - `items` object[]

## Changes

- **2026-10-28** `3198f11be70f`: 1 info
  - added the new optional `query` request parameter `customer_id`

[Operation history](https://skmtc.dev/bagisto/apis/bagisto-admin-api/changes/invoices/get.md)

---

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