1. system
XRechnung API
  • invoices
    • List stored invoices for the current API key
      GET
    • Queue invoice generation by default
      POST
    • Validate invoice JSON, raw XML, or raw ZUGFeRD PDF
      POST
    • Retrieve a previously generated invoice by ID
      GET
    • Download the stored invoice PDF artifact
      GET
  • system
    • Public liveness probe
      GET
    • Check runtime readiness for invoice validation
      GET
  • Schemas
    • InvoicePayload
    • SellerParty
    • InvoiceAllowance
    • PrecedingInvoiceReference
    • BuyerParty
    • InvoiceBranding
    • ValidationError
    • InvoiceLine
    • ValidationResult
    • GenerateQueuedResponse
    • GenerateSyncResponse
    • ValidateJsonResponse
    • ValidatePdfRequest
    • ValidateXmlRequest
    • ValidateXmlResponse
    • ValidatePdfResponse
    • GetInvoicePendingResponse
    • GetInvoiceTerminalResponse
    • GetInvoiceResponse
    • ListInvoiceSummary
    • PaginationMeta
    • ListInvoicesResponse
    • ReadinessResponse
    • UnauthorizedError
    • PaymentRequiredError
    • TooManyRequestsError
    • RequestValidationError
    • NotFoundError
  1. system

Public liveness probe

GET
/ping
Last modified:2026-08-18 20:04:38
Returns a liveness response for public API hubs, uptime monitors, and
lightweight service discovery checks.
The response format depends on the Accept request header: when it is
exactly application/json, a JSON object with status, timestamp, and
version is returned. Otherwise a single plain-text line with the same
fields (key: value pairs joined by commas) is returned.

Request

Authorization
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Header Params

Responses

🟢200
application/json
Service is reachable
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.xinvoice.net/v1/ping' \
--header 'Accept;' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "status": "OK",
    "timestamp": "2026-04-07T20:00:00.000000Z",
    "version": "1.0.0"
}
Modified at 2026-08-18 20:04:38
Previous
Download the stored invoice PDF artifact
Next
Check runtime readiness for invoice validation
Built with