Invoices

Get the public share link for an invoice or offer

Returns the recipient-facing view URL for an invoice or an offer - the same link the send mail contains. Use it to hand someone a payment or viewing link without sending mail from Lumabill.

POST because the first call mints and persists the public token. It is idempotent: a document that already carries a token keeps it, so the URL stays stable once shared. Works for offers too, since offers are stored alongside invoices. A draft is rejected (400): the link would expose an unfinished document with no login and no expiry. Profile-scoped like GET /invoices/{id}.

post/invoices/{id}/share-link

Request

  • Base URL: https://api.lumabill.ch/v1
  • URL: https://api.lumabill.ch/v1/invoices/{id}/share-link
  • Auth: HTTP bearer

Response

Share link

urlstring uri

Public view page for the document

paymentLinkstring uri nullable

Stripe checkout URL when online payment is configured on the document, otherwise null.

onlinePaymentboolean

Whether online payment is enabled on the document

Example response

{
  "url": "https://lumabill.ch/view/9f1c0c4a6b8e4d2f",
  "paymentLink": "https://checkout.stripe.com/c/pay/cs_live_123",
  "onlinePayment": true
}

Changes

No recorded changes to this operation across all 1 revision of this API.