reports

Verify a signed report of either version, without an account

Send the ZIP as application/zip. Ironfang Finance reads which manifest it carries (V1's or V2's) and checks the canonical manifest, the domain-separated signature against its own published keys, every bound member's hash and length, the readable page and, where the report requires one, its RFC 3161 timestamp. It performs no network access, no validation and no retention. HTTP 200 answers verified true or false; verified means the report is intact and issued by a trusted key, not that the invoice is valid: read invoice_outcome. report_schema names the manifest; family and scope are the release's (a V1 report is Peppol BIS Billing 3 at XML scope). Unknown or revoked keys, tampering and unknown schemas fail. For a completely local check, ironfang finance verify does the same with keys you obtain independently.

Bounded to 48 MiB compressed and expanded, nine members, two checks at a time per API process and 15 seconds. No query, compression or Idempotency-Key. Per-address anonymous limits apply.

post/v2/einvoices/reports/verify

Request

  • Base URL: https://api.ironfang.com/finance
  • URL: https://api.ironfang.com/finance/v2/einvoices/reports/verify
  • Auth: none required

Response

The integrity check. Cache-Control is no-store.

artifact_hashes'not_verified' | 'verified' | 'invalid' required
claimstring required
errorsstring[] required
family'peppol-bis-billing-3' | 'xrechnung' | 'zugferd-facturx'

An invoice family. zugferd-facturx is one family: ZUGFeRD and Factur-X are corresponding release names of the same standard.

invoice_outcome'valid' | 'invalid'
key_idstring
manifest_sha256string
operation_idstring
report_schema'financewolf/einvoice/report-manifest/v1' | 'ironfang/finance/einvoice/report-manifest/v2'
ruleset_idstring
schema'ironfang/finance/einvoice/report-verification/v2' required
scope'xml' | 'hybrid_pdf'
signature'not_verified' | 'verified' | 'invalid' | 'untrusted' required
timestamp'not_present' | 'not_verified' | 'verified' | 'invalid' required
verifiedboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.