v1

latestOpenAPI 3.0.12026-07-243686491.1 MB

Invoices

Retrieves an invoice by its id

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

get/api/v1/invoices/{invoiceId}

Path parameters

invoiceIdinteger required

Query parameters

teamIdinteger

Optional team ID to validate the invoice belongs to this team

Response

Invoice successfully retrieved

idinteger required

Id of the invoice

displayNumberstring 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.

walletIdinteger required

Id of the wallet

fromstring date-time required

Invoice from date

tostring date-time required

Invoice to date

approvedAtstring date-time nullable

The date it was approved

totalStatementnumber nullable

Total statement

totalPayableBalancenumber required

Total payable balance

status'paid' | 'unpaid' | 'settled' required

status of the invoice

createdAtstring date-time required

Invoice creation date

dueAtstring date-time nullable required

Invoice due date

pdfUrlstring nullable

URL to the invoice PDF

Example response

{
  "id": 123,
  "displayNumber": "3508-2026-6577",
  "walletId": 123,
  "from": "2024-03-01T00:00:00Z",
  "to": "2024-03-30T00:00:00Z",
  "approvedAt": "2024-03-30T00:00:00Z",
  "totalStatement": 12.22,
  "totalPayableBalance": 12.22,
  "currency": {
    "id": 1,
    "identifier": "DKK",
    "name": "Danish krone",
    "decimals": 2
  },
  "status": "paid",
  "createdAt": "2024-03-30T00:00:00Z",
  "dueAt": "2024-03-30T00:00:00Z",
  "pdfUrl": "https://monta.imgix.net/production/wallet/invoices/xyxy.pdf"
}