iotoms Docs

Get the invoice PDF

GET
/api/v1/transaction/transactions/{transactionId}/pdf

Returns a signed download link for the transaction's invoice PDF, rendered from your active invoice template. If no PDF exists yet, or the active template has changed since it was rendered, a new one is generated first.

Authorization

BearerAuth
headerAuthorizationBearer <JWT>

Path Parameters

transactionId*string

The sale to fetch the invoice for, from List transactions or Create a transaction from a cart.

Formatuuid

Header Parameters

Response Body

OK

*/*
  1. response
status*string

Outcome of the call: SUCCESS when the request worked, ERROR when it did not.

message*string

Short human-readable message describing the result, for logs or display; do not parse it.

data?|

Key-value result. For PDF endpoints: pdfUrl (a temporary signed download link), templateId, templateVersion, generatedAt plus document keys such as dayCycleId.

Example Request
curl -X GET 'https://beta.iotoms.com/api/v1/transaction/transactions/497f6eca-6276-4993-bfeb-53cbbbba6f08/pdf'
Example Response
{  "status": "string",  "message": "string",  "data": {    "property1": {},    "property2": {}  }}