---
title: "Retrieves a list of invoices by walletId"
method: GET
path: "/api/v1/invoices"
tags: ["Invoices"]
---

# Retrieves a list of invoices by walletId

`GET /api/v1/invoices`

Required scope: `invoices:read`

## Query parameters

- `page` integer
- `perPage` integer
- `walletId` integer, required
- `pageable` Pageable, required
  - `orderBy` SortOrder[], required
    - `ignoreCase` boolean, required
    - `direction` 'ASC' | 'DESC', required
    - `property` string, required
    - `ascending` boolean
  - `number` integer
  - `size` integer, required
  - `mode` 'CURSOR_NEXT' | 'CURSOR_PREVIOUS' | 'OFFSET'
  - `sort` Sort, required
    - `orderBy` SortOrder[], required
      - `ignoreCase` boolean, required
      - `direction` 'ASC' | 'DESC', required
      - `property` string, required
      - `ascending` boolean

## Response `200`

Invoices successfully retrieved

- OffsetBasedResponse12
  - `data` InvoiceDto[], required
    - `id` integer, required — Id of the invoice
    - `displayNumber` string, required — Human-readable invoice number shown on the PDF and in Monta Hub. For invoices issued after the sequencing rollout this is the official serial number (e.g. `3508-2026-6577`); older invoices fall back to the stringified id.
    - `walletId` integer, required — Id of the wallet
    - `from` string, date-time, required — Invoice from date
    - `to` string, date-time, required — Invoice to date
    - `approvedAt` string, date-time, nullable — The date it was approved
    - `totalStatement` number, nullable — Total statement
    - `totalPayableBalance` number, required — Total payable balance
    - `currency` CurrencyDto, required
      - `id` integer, nullable — id of the currency
      - `identifier` string, nullable — Currency identifier
      - `name` string, nullable — Readable name of currency
      - `decimals` integer — Number of decimals for this currency
    - `status` 'paid' | 'unpaid' | 'settled', required — status of the invoice
    - `createdAt` string, date-time, required — Invoice creation date
    - `dueAt` string, date-time, nullable, required — Invoice due date
    - `pdfUrl` string, nullable — URL to the invoice PDF
  - `meta` MontaPageMeta, required
    - `itemCount` integer, required
    - `currentPage` integer, required
    - `perPage` integer, required
    - `totalPageCount` integer, required
    - `totalItemCount` integer, required

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Operator doesn't have access to resource
- `404` — Entity with the provided id was not found

---

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