Marmin Oman Documentation

Download invoice PDF

Downloads the invoice as a PDF file. See the right panel for request examples.

GET /api/sales-invoices/{id}/download-pdf

Path parameters

Parameter	Type	Required	Description
`id`	string	Required	The ID of the invoice to download.

Response

Status code: 200 OK

Response headers:

Header	Description
`Content-Type`	`application/pdf`
`Content-Disposition`	`attachment; filename="INV-2024-001.pdf"` (filename may vary by invoice)

Response body: Returns the PDF file data in bytes.

PDF download is allowed when meta_info.peppol_status.overall_status is APPROVED, or when the document is a simplified invoice (transaction_type bit 1 is 1). Other Peppol statuses (PENDING, REJECTED, VALIDATION_FAILED) return 400.

Error responses

Status	Description
400 Bad Request	PDF is not allowed for this Peppol status, or the transaction type does not support PDF.
401 Unauthorized	Authentication required or invalid token.
403 Forbidden	User not authorized to access this invoice.
404 Not Found	Invoice not found.
500 Internal Server Error	An error occurred while processing the request.

Signature generation

# Base URL: https://api-sandbox.om.marmin.ai
# GET /api/sales-invoices/{id}/download-pdf

curl "https://api-sandbox.om.marmin.ai/api/sales-invoices/550e8400-e29b-41d4-a716-446655440000/download-pdf" \
  -H "Authorization: Bearer <access_token>" \
  -H "X-API-Version: 20260101" \
  -o invoice.pdf