Retrieve a previously generated invoice by ID

GET

/invoices/{id}

Returns the current state of a stored invoice for the authenticated API key.
Async clients can poll this endpoint until the status changes from queued
or processing to generated or failed.

By default the response omits inline PDF data even when a hybrid PDF exists.
Add include_pdf_data=1 only when the client explicitly needs pdf_base64.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Stored invoice found for the current API key

Body

🟠401

🟠402

🟠404

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.xinvoice.net/v1/invoices/?include_pdf_data' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Terminal stored invoice response

{
    "status": "generated",
    "invoice_id": "6c590ad5-e8c8-4f43-9c58-62fbbe993c15",
    "invoice_number": "RE-2026-001",
    "processing_mode": "async",
    "document_format": "xrechnung_ubl",
    "document_profile": "EN16931",
    "request_payload": {
        "document_format": "xrechnung_ubl",
        "invoice_number": "RE-2026-001",
        "issue_date": "2026-04-07T00:00:00.000Z",
        "due_date": "2026-04-21T00:00:00.000Z",
        "delivery_date": "2026-04-07T00:00:00.000Z",
        "buyer_reference": "04011000-12345-03",
        "payment_means_code": "58",
        "payment_terms_note": "Zahlbar bis 2026-04-21 ohne Abzug.",
        "currency": "EUR",
        "invoice_type_code": "380",
        "seller": {
            "name": "Muster GmbH",
            "vat_id": "DE123456789",
            "street": "Musterstr. 1",
            "postal_code": "12345",
            "city": "Berlin",
            "country_code": "DE",
            "email": "seller@example.com",
            "electronic_address_scheme": "EM",
            "contact_name": "Max Muster",
            "contact_email": "seller@example.com",
            "phone": "+49 30 1234567",
            "iban": "DE75512108001245126199"
        },
        "buyer": {
            "name": "Kunde GmbH",
            "street": "Hauptstr. 5",
            "postal_code": "54321",
            "city": "Hamburg",
            "country_code": "DE",
            "email": "buyer@example.com",
            "electronic_address_scheme": "EM"
        },
        "items": [
            {
                "name": "Webentwicklung",
                "quantity": 10,
                "unit_code": "HUR",
                "price": 100,
                "tax_rate": 19
            }
        ]
    },
    "validation": {
        "valid": true,
        "errors": []
    },
    "xml": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<Invoice xmlns:cac=\"urn:oasis:names:specification:ubl:schema:xsd:CommonAggregateComponents-2\" xmlns:cbc=\"urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2\" xmlns=\"urn:oasis:names:specification:ubl:schema:xsd:Invoice-2\">\n <cbc:CustomizationID>urn:cen.eu:en16931:2017#compliant#urn:xeinkauf.de:kosit:xrechnung_3.0</cbc:CustomizationID>\n <cbc:ProfileID>urn:fdc:peppol.eu:2017:poacc:billing:01:1.0</cbc:ProfileID>\n <cbc:ID>RE-2026-001</cbc:ID>\n <cbc:IssueDate>2026-04-07</cbc:IssueDate>\n <cbc:DueDate>2026-04-21</cbc:DueDate>\n <cbc:BuyerReference>04011000-12345-03</cbc:BuyerReference>\n</Invoice>\n",
    "queued_at": "2026-04-07T19:59:58+00:00",
    "started_at": "2026-04-07T19:59:59+00:00",
    "finished_at": "2026-04-07T20:00:00+00:00",
    "created_at": "2026-04-07T20:00:00+00:00",
    "updated_at": "2026-04-07T20:00:00+00:00",
    "processing_error": null
}

Modified at 2026-04-20 18:38:07

Validate invoice JSON, raw XML, or raw ZUGFeRD PDF

Download the stored invoice PDF artifact