Invoices

Retrieves a list of invoices by walletId

GET

https://partner-api.monta.com

/api/v1/invoices

Required scope: invoices:read

Retrieves a list of invoices by walletId › query Parameters

walletId

integer · int64 · required

Pageable · required

page

integer · int32

page number to retrieve (starts with 0)

Default: 0

perPage

integer · int32

number of items per page (between 1 and 100, default 10)

Default: 10

Retrieves a list of invoices by walletId › Responses

Invoices successfully retrieved

OffsetBasedResponse_32

InvoiceDto[] · required

MontaPage.Meta · required

GET/api/v1/invoices

curl 'https://partner-api.monta.com/api/v1/invoices?walletId=<number>&pageable=<value>' \
  --header 'Authorization: Bearer <token>'

Example Responses

{
  "data": [
    {
      "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"
    }
  ],
  "meta": {
    "itemCount": 0,
    "currentPage": 0,
    "perPage": 0,
    "totalPageCount": 0,
    "totalItemCount": 0
  }
}

json

application/json

Retrieves an invoice by its id

GET

https://partner-api.monta.com

/api/v1/invoices/{invoiceId}

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

Retrieves an invoice by its id › path Parameters

invoiceId

integer · int64 · required

Retrieves an invoice by its id › query Parameters

teamId

integer · int64

Optional team ID to validate the invoice belongs to this team

Retrieves an invoice by its id › Responses

Invoice successfully retrieved

InvoiceDto

id

integer · int64 · required

Id of the invoice

Example: 123

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.

Example: 3508-2026-6577

walletId

integer · int64 · required

Id of the wallet

Example: 123

from

string · date-time · required

Invoice from date

Example: 2024-03-01T00:00:00Z

to

string · date-time · required

Invoice to date

Example: 2024-03-30T00:00:00Z

totalPayableBalance

number · required

Total payable balance

Example: 12.22

object · required

Currency

status

string · enum · required

status of the invoice

Enum values:

paid

unpaid

settled

Example: paid

createdAt

string · date-time · required

Invoice creation date

Example: 2024-03-30T00:00:00Z

dueAt

string | null · date-time · required

Invoice due date

Example: 2024-03-30T00:00:00Z

approvedAt

string | null · date-time

The date it was approved

Example: 2024-03-30T00:00:00Z

totalStatement

number | null

Total statement

Example: 12.22

pdfUrl

string | null

URL to the invoice PDF

Example: https://monta.imgix.net/production/wallet/invoices/xyxy.pdf

Installer Jobs Issues