v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-0281419.4 KB
Verification

Verify an invoice by fiscal number

Public endpoint — no authentication required. Rate-limited to 30 requests/minute per IP. Verifies invoice authenticity by checking signature and ledger chain integrity.

get/api/fiscal/verify/{fiscalNumber}

Path parameters

fiscalNumberstring required

Fiscal number (format: {outletId}-{paddedNumber})

Query parameters

auth_codestring required

8-character authorization code printed on the invoice

Response

Verification result

status'verified' | 'not_found' | 'tampered'
fiscalNumberstring
messagestring nullable
merchantNamestring nullable
outletNamestring nullable
timestampstring date-time nullable
totalstring nullable
currencystring nullable
invoiceTypestring nullable
signatureValidboolean nullable
ledgerChainValidboolean nullable