Skip to main content
GET
Get an invoice
Requires scope: view:billing — see Required scopes. Returns one issued invoice in full. Unsent, voided, foreign and unknown invoice ids all answer the same 404 invoice-not-found.

Authorizations

FlowClient Credentials
Token URL
https://login-staging.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token

Headers

x-tenant-id
string<uuid>

Which tenant the request is scoped to, among those your token grants. Omit it when the token grants exactly one tenant; it is required when the token grants more than one. A supplied value must exactly match a tenant the token grants.

Absent when required, blank, malformed, or naming a tenant the token does not grant — each gets the same generic 403 forbidden, which reveals neither whether a tenant exists nor which ones you may use. Send the header once: a repeated header is rejected the same way.

Example:

"3fa85f64-5717-4562-b3fc-2c963f66afa6"

Path Parameters

invoiceId
string<uuid>
required

Invoice identifier, as returned by the invoice list

Response

The invoice

success
boolean

Indicates whether the request was successful

result
object

One invoice Venly issued to your company, read live from our billing system. Finance stores no invoices. sequenceUrl is Venly's internal reference to the invoice and is not a page you can open; read your invoices in the billing portal at billingUrl on Get your company profile, or download one with Download an invoice PDF.