Skip to Content
HelvetlyDocs
API referenceInvoices

Download the e-invoice XML

Needs a token with the read:invoices scope (or write:invoices). Authentication

Try in Playground sends a real request to app.helvetly.com with a token you paste. It stays in this browser tab only (session storage) and goes to no one else.

GET
/api/v1/invoices/{id}/einvoice

The structured XML of an issued invoice or credit note in the chosen format: xrechnung-ubl, xrechnung-cii (XRechnung), peppol (Peppol BIS UBL), ro-cius (RO e-Factura for SPV) or ksef-fa3 (Polish KSeF FA(3), PLN only). The first export of a format archives the bytes (SHA-256 in X-Helvetly-XML-SHA256); later calls return the archived bytes unchanged. Answers 409 invalid_state for drafts, issued_elsewhere for imported invoices, and einvoice_* codes when data is missing (seller contact, endpoint, NIP, VAT categories). Synthetic validation only: the response carries X-Helvetly-Preview: true; check the recipient's requirements. Peppol delivery is not done by this call.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A personal API token, hvt_…, with scopes such as read:* or write:invoices

Path Parameters

id*string

The invoice's id.

Query Parameters

format*string

The XML profile.

Value in"xrechnung-ubl""xrechnung-cii""peppol""ro-cius""ksef-fa3"

Response Body

The XML file.

response?fileapplication/xml
Formatbinary
Example Request
curl -X GET 'https://app.helvetly.com/api/v1/invoices/string/einvoice?format=xrechnung-ubl'
Example Response
"string"