Masumi Logo

/invoice-monthly-missing

Finds billable payment requests that do not yet have an invoice for a given month. Only finalized payments are included: Withdrawn (seller completed work), ResultSubmitted past unlock time, or DisputedWithdrawn with seller funds. Payments still locked, pending refund, or in dispute are excluded. (+PAY access required)

BETA: This invoice feature is in beta. Generated invoices should be reviewed manually or verified with a tax advisor before use. Use at your own discretion.

GET
/invoice/monthly/missing
token<token>

API key authentication via header (token)

In: header

Query Parameters

month*string

Target month in format YYYY-MM (UTC calendar)

Match^\d{4}-\d{2}$
buyerWalletVkey?string

Optional buyer wallet vkey filter

Lengthlength <= 1000
cursorId?string

Cursor for pagination (PaymentRequest id)

limit?number

Number of results to return

Default10
Range1 <= value <= 100

Response Body

application/json

curl -X GET "https://loading/./../api/v1/invoice/monthly/missing?month=string"
{
  "status": "Success",
  "data": {
    "UninvoicedPayments": [
      {
        "id": "payment_request_id",
        "blockchainIdentifier": "blockchain_identifier",
        "onChainState": "Withdrawn",
        "createdAt": "2025-09-15T10:00:00.000Z",
        "buyerWalletVkey": "buyer_wallet_vkey",
        "buyerWalletAddress": "addr1...",
        "RequestedFunds": [
          {
            "unit": "",
            "amount": "5000000"
          }
        ]
      }
    ]
  }
}
Masumi Kanji