List stored invoices for the current API key

GET

/invoices

Returns paginated invoice summaries scoped to the authenticated API key.
This endpoint is intended for operational overviews and lightweight client
listings, so it does not include full XML payloads.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

Responses

🟢200

application/json

Paginated invoice summaries for the current API key

Body

🟠401

🟠402

🟠422

🟠429

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.xinvoice.net/v1/invoices?status&invoice_number&created_from&created_to&per_page&page' \
--header 'Authorization: Bearer <token>'

Response Example

200 - found

{
    "data": [
        {
            "invoice_id": "6c590ad5-e8c8-4f43-9c58-62fbbe993c15",
            "invoice_number": "RE-2026-001",
            "status": "generated",
            "processing_mode": "async",
            "document_format": "zugferd",
            "document_profile": "EN16931",
            "pdf_available": true,
            "validation_valid": true,
            "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"
        }
    ],
    "meta": {
        "current_page": 1,
        "per_page": 10,
        "last_page": 1,
        "total": 1
    }
}

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

Check runtime readiness for invoice validation