---
title: "Retrieves an invoice by its id"
method: GET
path: "/api/v1/invoices/{invoiceId}"
tags: ["Invoices"]
---

# Retrieves an invoice by its id

`GET /api/v1/invoices/{invoiceId}`

Required scope: `invoices:read`. Optionally filter by teamId to validate invoice belongs to that team.

## Path parameters

- `invoiceId` integer, required

## Query parameters

- `teamId` integer

## Response `200`

Invoice successfully retrieved

- InvoiceDto
  - `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

## Other responses

- `400` — The request is invalid
- `401` — Consumer with provided credentials was not found
- `403` — Consumer does not have access to the specified team or invoice does not belong to the team
- `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)