Get a signed message to request a monthly invoice. (+PAY access required)

Provides a signed message from the smart contract wallet to authorize monthly invoice retrieval for a buyer wallet. (+PAY access required)

post/signature/sign/create-invoice/monthly

Request

Base URL: ./../api/v1/ (relative, and the document was published on a file host, not at the API’s origin)
URL: ./../api/v1/signature/sign/create-invoice/monthly
Auth: API key in header token

Request body

buyerWalletVkeystring required

The buyer wallet vkey for which to aggregate the month

monthstring required

Target month in format YYYY-MM (UTC calendar)

action'RetrieveMonthlyInvoices' required

The action to perform for monthly invoices

Example request

{
  "action": "RetrieveMonthlyInvoices",
  "buyerWalletVkey": "buyer_wallet_vkey",
  "month": "2025-09",
  "Buyer": {
    "country": "DE",
    "city": "Berlin",
    "zipCode": "10115",
    "street": "Buyer Str.",
    "streetNumber": "2",
    "email": "buyer@example.com",
    "phone": "+49 30 987654",
    "name": "Bob",
    "companyName": null,
    "vatNumber": null
  }
}

Response

Monthly signature generated

statusstring required

Example response

{
  "status": "Success",
  "data": {
    "signature": "ed25519_signature",
    "key": "ed25519_key",
    "walletAddress": "addr1...",
    "signatureData": "{\"action\":\"RetrieveMonthlyInvoices\",\"validUntil\":1736352000000,\"hash\":\"...\"}"
  }
}

Changes

No recorded changes to this operation across all 50 revisions of this API.