{"openapi":"3.1.0","info":{"title":"INVOX","description":"XRechnung / ZUGFeRD validation API (EU-first, zero-retention). New here? See the [Quickstart](/v1/quickstart) for a working example in under 5 minutes, or download the [Postman collection](/postman/INVOX.postman_collection.json).","version":"0.1.0","contact":{"name":"FineLuxury UG (INVOX)","url":"https://invoxapi.de/impressum"},"termsOfService":"https://invoxapi.de/?page=agb","x-api-auth":{"type":"apiKey","in":"header","name":"X-API-Key","format":"in_<32 hex>_fl"}},"paths":{"/v1/quickstart":{"get":{"summary":"Customer API quickstart (Markdown)","description":"The same CUSTOMER_API_QUICKSTART.md shipped in the repo, served here so it has a stable, linkable URL. No authentication.","operationId":"quickstart_v1_quickstart_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/status/maintenance":{"get":{"summary":"Maintenance mode status","description":"Whether INVOX is currently in announced maintenance (Sektion 99) and the customer-facing message, if any. A frontend polls this to show a banner. This never affects the API itself — see invox.governance.maintenance_mode. No authentication required.","operationId":"maintenance_status_v1_status_maintenance_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Maintenance Status V1 Status Maintenance Get"}}}}}}},"/v1/status-page":{"get":{"summary":"Public incident status feed","description":"Incidents an admin explicitly published (Sektion 137) — only severity, status, timestamps and an admin-authored public_summary, never internal fields (title/services/root_cause/resolution/owner) — PLUS `subsystems`: real, computed-on-demand health for API/Validation/Delivery/Reporting/Peppol/Webhooks/Dashboard, derived from actual recent request outcomes and webhook delivery/circuit-breaker state (invox.nox.status_health), never a fabricated uptime number. A subsystem with no real signal yet reports 'insufficient_data' rather than a fake green checkmark. No authentication required.","operationId":"status_page_v1_status_page_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Status Page V1 Status Page Get"}}}}}}},"/v1/changelog":{"get":{"summary":"Public changelog","description":"Published release notes (Sektion 70) — the same release records the backoffice manages, filtered to those an admin marked changelog_visible. No authentication required.","operationId":"changelog_v1_changelog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Changelog V1 Changelog Get"}}}}}}},"/v1/languages":{"get":{"summary":"Supported guidance languages","description":"Lists the languages the API can return error guidance in, plus the language recommended for the caller (from ?lang or Accept-Language). No authentication required.","operationId":"languages_v1_languages_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Languages V1 Languages Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/health":{"get":{"summary":"Health check","description":"Returns service liveness status. No authentication required.","operationId":"health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health V1 Health Get"}}}}}}},"/v1/health/ready":{"get":{"summary":"Readiness check (dependencies)","description":"Checks the validation engine (Java/KoSIT), the evidence dir and the signing key. Returns 503 if a critical dependency is unavailable. No authentication required.","operationId":"readiness_v1_health_ready_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Readiness V1 Health Ready Get"}}}}}}},"/.well-known/security.txt":{"get":{"summary":"RFC 9116 security contact info","operationId":"security_txt__well_known_security_txt_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/.well-known/invox-attestation-keys.json":{"get":{"summary":"Published attestation public keys (trust anchor)","description":"Active + retired Ed25519 public keys. No authentication. Pin these to verify attestations offline.","operationId":"attestation_keys__well_known_invox_attestation_keys_json_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Attestation Keys  Well Known Invox Attestation Keys Json Get"}}}}}}},"/v1/attestation/verify":{"post":{"summary":"Verify an Invox attestation against the published trust anchor","description":"Public, free. Verifies the signature against Invox's own published key (matched by key_id), not the embedded key.","operationId":"verify_v1_attestation_verify_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Attestation"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Verify V1 Attestation Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/verifier/standalone_verifier.py":{"get":{"summary":"Download the offline attestation verifier (zero dependencies)","description":"A single self-contained Python file (stdlib only — no pip install, no network call to Invox) that verifies an Invox attestation's Ed25519 signature against a trusted public key you supply. This is the genuine offline-verifiable path — see /.well-known/invox-attestation-keys.json for the trust anchor. No authentication.","operationId":"download_standalone_verifier_verifier_standalone_verifier_py_get","responses":{"200":{"description":"Successful Response","content":{"text/plain":{"schema":{"type":"string"}}}}}}},"/v1/validate":{"post":{"summary":"Validate an e-invoice","description":"Upload an invoice file (XML or PDF). The file is validated against the detected format (XRechnung, ZUGFeRD, Factur-X, EN16931). Document bytes are never stored — only SHA-256 hash and validation result. Each request produces a full evidence pack (JSON + PDF) with human-readable German messages, NOX security decision, and reproducibility info. Supports an `Idempotency-Key` header — a retried request with the same key returns the original result (same request_id and verdict) without re-charging; because no invoice content is retained, rule messages and key data are re-derived from the re-uploaded file.","operationId":"validate_invoice_v1_validate_post","parameters":[{"name":"direction","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(inbound|outbound)$"},{"type":"null"}],"default":"inbound","title":"Direction"}},{"name":"profile_hint","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(xrechnung|zugferd|facturx|en16931|peppol)$"},{"type":"null"}],"title":"Profile Hint"}},{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Guidance language (de, en). Defaults to the tenant's saved pdf_language (see POST /v1/auth/portal/pdf-language), then Accept-Language, then de.","title":"Lang"},"description":"Guidance language (de, en). Defaults to the tenant's saved pdf_language (see POST /v1/auth/portal/pdf-language), then Accept-Language, then de."},{"name":"ruleset","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Pin the validation ruleset (see GET /v1/rulesets). Omitted = the default ruleset. Unknown or not yet available rulesets are refused with 422 -- there is never a silent fallback to another version.","title":"Ruleset"},"description":"Pin the validation ruleset (see GET /v1/rulesets). Omitted = the default ruleset. Unknown or not yet available rulesets are refused with 422 -- there is never a silent fallback to another version."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_validate_invoice_v1_validate_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationResult"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"example":{"detail":{"error_code":"INVALID_API_KEY","message":"API key is not recognised."}}}}},"402":{"description":"Quota exhausted, or a past-due payment has passed its grace period.","content":{"application/json":{"example":{"detail":{"error_code":"QUOTA_EXCEEDED","message":"Validation quota exhausted. Purchase more credits or contact your operator.","current_usage":2000,"limit":2000}}}}},"409":{"description":"An identical request (same Idempotency-Key, or identical content when no key is supplied) is already being processed concurrently.","content":{"application/json":{"example":{"detail":{"error_code":"DUPLICATE_IN_PROGRESS","message":"An identical submission is already being processed."}}}}},"413":{"description":"Upload exceeds the endpoint's file-size limit.","content":{"application/json":{"example":{"detail":{"error_code":"FILE_TOO_LARGE","message":"File exceeds 25 MB limit"}}}}},"429":{"description":"Rate limit exceeded for this tenant (bucketed across all of the tenant's API keys, not per individual key).","content":{"application/json":{"example":{"detail":{"error_code":"RATE_LIMITED","message":"Rate limit exceeded. Retry after the window resets."}}}}},"503":{"description":"The endpoint's dependency (e.g. AI extraction, a national clearance sender) is not configured in this deployment, or is temporarily overloaded.","content":{"application/json":{"example":{"detail":{"error_code":"SYSTEM_OVERLOADED","message":"Der Validierungsdienst ist aktuell ausgelastet. Bitte in Kürze erneut versuchen."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/remediate":{"post":{"summary":"Fix-and-prove: validate → autofix → re-validate → attest (one call)","description":"Validates an invoice, applies safe autofixes, re-validates, and returns the corrected invoice plus a signed attestation of the corrected version.","operationId":"remediate_v1_remediate_post","parameters":[{"name":"profile_hint","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(xrechnung|zugferd|facturx|en16931|peppol)$"},{"type":"null"}],"title":"Profile Hint"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_remediate_v1_remediate_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RemediateResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/rules/{rule_id}/fix-guide":{"get":{"tags":["rules"],"summary":"Fix via API: guide and example code for a rule","operationId":"fix_guide_v1_rules__rule_id__fix_guide_get","parameters":[{"name":"rule_id","in":"path","required":true,"schema":{"type":"string","title":"Rule Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Fix Guide V1 Rules  Rule Id  Fix Guide Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rulesets":{"get":{"tags":["rules"],"summary":"Available and planned validation rulesets","operationId":"rulesets_v1_rulesets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Rulesets V1 Rulesets Get"}}}}}}},"/v1/report/drr":{"post":{"tags":["report"],"summary":"Derive the ViDA DRR transaction report from an invoice (signed)","operationId":"report_drr_v1_report_drr_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_report_drr_v1_report_drr_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DRRResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/validate/batch":{"post":{"tags":["validate"],"summary":"Validate multiple e-invoices in one request","description":"Upload up to INVOX_BATCH_MAX_SIZE (default 50) invoice files. Each file is validated through the same pipeline as /v1/validate. Instead of individual files, you may upload a single ZIP archive (filename ending in .zip, or content-type application/zip) containing up to INVOX_BATCH_MAX_SIZE top-level .xml/.pdf invoice files — a ZIP must be the only file in the request, it cannot be mixed with individual files. Zero-retention: all file bytes are wiped after processing. Results are returned in submission order. Supports an `Idempotency-Key` header for the whole batch — a retry is not charged again; because no invoice content is retained, each file's rule messages are re-derived for the retry.","operationId":"validate_batch_v1_validate_batch_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_validate_batch_v1_validate_batch_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchValidationResult"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"example":{"detail":{"error_code":"INVALID_API_KEY","message":"API key is not recognised."}}}}},"402":{"description":"Quota exhausted, or a past-due payment has passed its grace period.","content":{"application/json":{"example":{"detail":{"error_code":"QUOTA_EXCEEDED","message":"Validation quota exhausted. Purchase more credits or contact your operator.","current_usage":2000,"limit":2000}}}}},"409":{"description":"An identical request (same Idempotency-Key, or identical content when no key is supplied) is already being processed concurrently.","content":{"application/json":{"example":{"detail":{"error_code":"DUPLICATE_IN_PROGRESS","message":"An identical submission is already being processed."}}}}},"413":{"description":"Upload exceeds the endpoint's file-size limit.","content":{"application/json":{"example":{"detail":{"error_code":"FILE_TOO_LARGE","message":"File exceeds 25 MB limit"}}}}},"429":{"description":"Rate limit exceeded for this tenant (bucketed across all of the tenant's API keys, not per individual key).","content":{"application/json":{"example":{"detail":{"error_code":"RATE_LIMITED","message":"Rate limit exceeded. Retry after the window resets."}}}}},"503":{"description":"The endpoint's dependency (e.g. AI extraction, a national clearance sender) is not configured in this deployment, or is temporarily overloaded.","content":{"application/json":{"example":{"detail":{"error_code":"SYSTEM_OVERLOADED","message":"Der Validierungsdienst ist aktuell ausgelastet. Bitte in Kürze erneut versuchen."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/export/datev":{"post":{"tags":["export"],"summary":"Export a batch of invoices as a DATEV EXTF Buchungsstapel CSV","description":"Upload up to INVOX_BATCH_MAX_SIZE (default 50) invoice files (UBL/CII XML). Returns a DATEV EXTF 'Buchungsstapel' CSV (cp1252, ';'-delimited, CRLF line endings) with one header-level booking line per invoice — gross amount debited to `debtor_account`, credited to a VAT-rate-appropriate revenue account; a credit note (document type 381) credits the debtor account instead (Soll/Haben-Kennzeichen H, unsigned amount, Buchungstext GS). Only documents in EUR are booked (another currency is skipped, not booked as euros). This is a header-level export (no automatic per-line-item chart-of-accounts postings) meant to be confirmed/adjusted once on import by the tenant's Steuerberater, same as any pre-accounting export. Invoices that cannot be parsed for booking are skipped (not fatal to the batch, listed in the X-Invox-Datev-Skipped response header) — the request fails only if *no* invoice in the batch yields a bookable line. Zero-retention: invoice bytes are wiped immediately after the CSV is built.","operationId":"export_datev_v1_export_datev_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_export_datev_v1_export_datev_post"}}}},"responses":{"200":{"description":"DATEV EXTF Buchungsstapel CSV.","content":{"application/json":{"schema":{}},"text/csv":{}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"example":{"detail":{"error_code":"INVALID_API_KEY","message":"API key is not recognised."}}}}},"402":{"description":"Quota exhausted, or a past-due payment has passed its grace period.","content":{"application/json":{"example":{"detail":{"error_code":"QUOTA_EXCEEDED","message":"Validation quota exhausted. Purchase more credits or contact your operator.","current_usage":2000,"limit":2000}}}}},"409":{"description":"An identical request (same Idempotency-Key, or identical content when no key is supplied) is already being processed concurrently.","content":{"application/json":{"example":{"detail":{"error_code":"DUPLICATE_IN_PROGRESS","message":"An identical submission is already being processed."}}}}},"413":{"description":"Upload exceeds the endpoint's file-size limit.","content":{"application/json":{"example":{"detail":{"error_code":"FILE_TOO_LARGE","message":"File exceeds 25 MB limit"}}}}},"429":{"description":"Rate limit exceeded for this tenant (bucketed across all of the tenant's API keys, not per individual key).","content":{"application/json":{"example":{"detail":{"error_code":"RATE_LIMITED","message":"Rate limit exceeded. Retry after the window resets."}}}}},"503":{"description":"The endpoint's dependency (e.g. AI extraction, a national clearance sender) is not configured in this deployment, or is temporarily overloaded.","content":{"application/json":{"example":{"detail":{"error_code":"SYSTEM_OVERLOADED","message":"Der Validierungsdienst ist aktuell ausgelastet. Bitte in Kürze erneut versuchen."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/usage":{"get":{"summary":"Tenant usage statistics","description":"Returns request counts, error rate, and quota status for the current tenant.","operationId":"get_usage_v1_usage_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Usage V1 Usage Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/quota":{"get":{"summary":"Quota status","description":"Returns quota limit, used count, remaining, and overage flag.","operationId":"get_quota_v1_quota_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Quota V1 Quota Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ux/measure":{"post":{"tags":["ux"],"summary":"Record an aggregate UX timing sample","operationId":"measure_v1_ux_measure_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UXMeasure"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Measure V1 Ux Measure Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ux/feedback":{"post":{"tags":["ux"],"summary":"Record one pilot feedback choice","operationId":"feedback_v1_ux_feedback_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UXFeedback"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Feedback V1 Ux Feedback Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/ux/metrics":{"get":{"tags":["ux"],"summary":"Read the caller's aggregate UX metrics","operationId":"metrics_v1_ux_metrics_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Metrics V1 Ux Metrics Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/me":{"get":{"tags":["me"],"summary":"Calling tenant's profile","operationId":"get_me_v1_me_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/invox__api__routes__me__MeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]},"put":{"tags":["me"],"summary":"Set the display name (for greeting)","operationId":"update_me_v1_me_put","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateMeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/invox__api__routes__me__MeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/data-export":{"get":{"tags":["me"],"summary":"DSGVO Art. 15/20 — export all personal/account data as machine-readable JSON","description":"Self-service data portability: bundles the account's own profile, usage/quota, API key metadata (masked — secrets are never re-shown after creation) and paid subscription invoices into one JSON document. Invoice *content* (the XML/PDF bytes submitted for validation) is deliberately absent — INVOX's zero-retention architecture never persists it, so there is nothing to export beyond what the evidence hash-chain already returns per request_id via GET /v1/evidence/{request_id}.","operationId":"data_export_v1_data_export_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Data Export V1 Data Export Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/plans":{"get":{"tags":["billing"],"summary":"Public B2B plans (distinct tiers, included credits, features)","operationId":"plans_v1_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Plans V1 Plans Get"}}}}}}},"/v1/usage/status":{"get":{"tags":["billing"],"summary":"Plan usage status: warnings, overage, spend cap, upgrade hint","operationId":"usage_status_v1_usage_status_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Usage Status V1 Usage Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/billing/plan":{"post":{"tags":["billing"],"summary":"Assign the calling tenant's plan (no payment triggered)","operationId":"set_plan_v1_billing_plan_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetPlanRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Plan V1 Billing Plan Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/billing/spend-cap":{"post":{"tags":["billing"],"summary":"Set the calling tenant's own monthly overage-spend budget limit","description":"Self-service budget control: cap monthly overage spend below what the current plan technically allows, to avoid bill surprises. Can only TIGHTEN the limit — a value above the plan's own monthly_spend_cap_eur is clamped down to the plan's cap, never raised above it. Pass null to remove the override and fall back to the plan default.","operationId":"set_spend_cap_v1_billing_spend_cap_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetSpendCapRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Spend Cap V1 Billing Spend Cap Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/pricing":{"get":{"tags":["billing"],"summary":"Public pricing (transparent, metered)","operationId":"pricing_v1_pricing_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pricing V1 Pricing Get"}}}}}}},"/v1/pricing/estimate":{"get":{"tags":["billing"],"summary":"Estimate the monthly cost for a credit volume","operationId":"pricing_estimate_v1_pricing_estimate_get","parameters":[{"name":"credits","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Credits"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Pricing Estimate V1 Pricing Estimate Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/pricing/enterprise/estimate":{"get":{"tags":["billing"],"summary":"Enterprise configurator: dynamic price for a chosen monthly credit volume, service level and format count","operationId":"pricing_enterprise_estimate_v1_pricing_enterprise_estimate_get","parameters":[{"name":"credits","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Credits"}},{"name":"service_level","in":"query","required":false,"schema":{"type":"string","default":"standard","title":"Service Level"}},{"name":"formats","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Formats"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Pricing Enterprise Estimate V1 Pricing Enterprise Estimate Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/stripe/webhook":{"post":{"tags":["billing"],"summary":"Stripe webhook (signature-verified)","operationId":"stripe_webhook_v1_stripe_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Stripe Webhook V1 Stripe Webhook Post"}}}}}}},"/v1/billing/subscribe":{"post":{"tags":["billing"],"summary":"Start a metered Stripe subscription for the calling tenant","operationId":"subscribe_v1_billing_subscribe_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubscribeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/billing/portal":{"post":{"tags":["billing"],"summary":"Open the Stripe self-service portal (manage/cancel subscription)","description":"Return a Stripe-hosted billing-portal URL so the customer can manage or\ncancel their subscription, update payment details and download invoices.\n\nFail-closed: 503 when billing is unconfigured, 409 when the tenant has no\nlinked Stripe customer yet (no subscription started).","operationId":"billing_portal_v1_billing_portal_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortalResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/billing/invoices":{"get":{"tags":["billing"],"summary":"List the tenant's paid INVOX subscription invoices","operationId":"list_invoices_v1_billing_invoices_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Invoices V1 Billing Invoices Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/billing/invoices/{number}.xml":{"get":{"tags":["billing"],"summary":"Download one invoice as a KoSIT-valid XRechnung","operationId":"download_invoice_xml_v1_billing_invoices__number__xml_get","parameters":[{"name":"number","in":"path","required":true,"schema":{"type":"string","title":"Number"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/billing/status":{"get":{"tags":["billing"],"summary":"Tenant billing link status","operationId":"billing_status_v1_billing_status_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Billing Status V1 Billing Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/audit/verify":{"get":{"tags":["audit"],"summary":"Verify the audit-chain integrity (content-free)","operationId":"audit_verify_v1_audit_verify_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Audit Verify V1 Audit Verify Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/audit/certificate":{"get":{"tags":["audit"],"summary":"Signed, offline-verifiable conformance certificate for the calling tenant","description":"A content-free, Ed25519-signed summary of the tenant's validation history\n(\"N validations, M conformant, tamper-evident chain intact, period A–B\").\n\nThe auditor / Steuerberater verifies it OFFLINE with the standalone verifier\n+ the published public key — proving the compliance record without trusting\nINVOX's servers and without ever seeing invoice content. No competitor offers\na signed, independently-verifiable tenant conformance certificate.","operationId":"audit_certificate_v1_audit_certificate_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Audit Certificate V1 Audit Certificate Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/audit/report":{"get":{"tags":["audit"],"summary":"Machine-readable audit / certification summary","operationId":"audit_report_v1_audit_report_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Audit Report V1 Audit Report Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/contact":{"post":{"tags":["contact"],"summary":"Public contact form (abuse-hardened)","operationId":"contact_v1_contact_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Contact V1 Contact Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/demo/validate":{"post":{"tags":["demo"],"summary":"Anonymous, no-login demo validation (rate-limited teaser)","description":"Validates a small XML invoice or a ZUGFeRD/Factur-X PDF with the REAL validation engine — no API key, no registration, no tenant. Rate-limited to 5 requests/hour per IP. XML (`xml`) capped at 50 KB; PDF (`pdf_base64`) capped at 512 KB decoded. Produces no evidence pack, no attestation, no quota/billing impact: this is a teaser for a first-time visitor, not a billable or auditable action. Use /v1/validate with a real API key for production integration.","operationId":"demo_validate_v1_demo_validate_post","parameters":[{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DemoValidateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/references/reconcile":{"post":{"tags":["references"],"summary":"Match invoice references against ERP or customer context","description":"Compare BT-10 buyer reference, BT-12 contract, BT-13/14 order, and BT-15/16 receiving/despatch references with values supplied by the caller. The endpoint returns matched, missing, or mismatch flags without echoing reference identifiers and never persists invoice content.","operationId":"reconcile_v1_references_reconcile_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_reconcile_v1_references_reconcile_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReferenceReconcileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/references/reconcile-context":{"post":{"tags":["references"],"summary":"Match invoice references against an ERP export","description":"Accept an ephemeral JSON or CSV context export in addition to the invoice. Use columns field,value or a single row with BT-10/12..16 headers. No invoice, context values, credentials, or source content are persisted.","operationId":"reconcile_context_v1_references_reconcile_context_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_reconcile_context_v1_references_reconcile_context_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContextReconcileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/help/assistant":{"post":{"tags":["help"],"summary":"Ask Emily, the INVOX support assistant (public)","description":"Emily answers from the FAQ; cancellation/refund are discussed for a couple of\nrounds before escalating; other binding topics or low confidence escalate at once.\nEscalations are written to the operator inbox so a human follows up. No external\nLLM and no web search: the only external call is a place-name lookup at Open-Meteo\nfor weather questions. Fail-closed.","operationId":"help_assistant_v1_help_assistant_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssistantRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Help Assistant V1 Help Assistant Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/help/faq":{"get":{"tags":["help"],"summary":"Categorised FAQ / Help Center (public)","operationId":"help_faq_v1_help_faq_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Help Faq V1 Help Faq Get"}}}}}}},"/v1/help/support-levels":{"get":{"tags":["help"],"summary":"Per-plan support levels + contact categories (public)","operationId":"help_support_levels_v1_help_support_levels_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Help Support Levels V1 Help Support Levels Get"}}}}}}},"/v1/help/support":{"get":{"tags":["help"],"summary":"The calling tenant's support level","operationId":"help_support_v1_help_support_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Help Support V1 Help Support Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/insights/health":{"get":{"summary":"Your compliance health over time (error-rate trend + top issues)","description":"Per-tenant validation health: error-rate trend, top recurring issues (in your language), and whether you are improving. Your own data; content-free.","operationId":"health_v1_insights_health_get","parameters":[{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Health V1 Insights Health Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/insights/common-issues":{"get":{"summary":"Most common validation failures for a format (anonymised, ranked)","description":"Top failing rules across all tenants, k-anonymised, enriched with fix hints.","operationId":"common_issues_v1_insights_common_issues_get","parameters":[{"name":"format","in":"query","required":true,"schema":{"type":"string","description":"detected format, e.g. PEPPOL_UBL, XRECHNUNG_3_UBL","title":"Format"},"description":"detected format, e.g. PEPPOL_UBL, XRECHNUNG_3_UBL"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Common Issues V1 Insights Common Issues Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/keys":{"get":{"summary":"List sub-API keys","operationId":"list_keys_v1_keys_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SubKeyOut"},"title":"Response List Keys V1 Keys Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]},"post":{"summary":"Create a sub-API key","operationId":"create_key_v1_keys_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKeyRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubKeyOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/keys/{key_id}/ip-allowlist":{"put":{"summary":"Update a sub-API key's IP allowlist","operationId":"update_ip_allowlist_v1_keys__key_id__ip_allowlist_put","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateIpAllowlistRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubKeyOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/keys/{key_id}":{"delete":{"summary":"Revoke a sub-API key","operationId":"revoke_key_v1_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence":{"get":{"summary":"List this tenant's evidence records","description":"Every validation/generation this API key's tenant has ever produced a proof for, newest first — so a customer never has to have saved a request_id themselves to find it again. Fetch /evidence/{request_id}, /full, or /report.pdf for any id returned here.","operationId":"list_evidence_v1_evidence_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Evidence V1 Evidence Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/{request_id}":{"get":{"summary":"Retrieve evidence manifest","description":"Return the minimal evidence manifest for a request_id (doc hash, format, verdict). Use /full for the complete record or /report.pdf for the PDF report. Access restricted to the owning tenant.","operationId":"get_evidence_v1_evidence__request_id__get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Evidence V1 Evidence  Request Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/{request_id}/full":{"get":{"summary":"Retrieve full evidence record","description":"Return the complete EvidenceRecord as JSON: errors (human+technical), warnings, autofix candidates, NOX decision, retention status, reproducibility info. Access restricted to the owning tenant.","operationId":"get_evidence_full_v1_evidence__request_id__full_get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Evidence Full V1 Evidence  Request Id  Full Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/{request_id}/attestation":{"get":{"summary":"Retrieve the signed attestation for this request","description":"The Ed25519-signed, offline-verifiable attestation for this validation (schema, entry, entry_hash, key_id, public_key, signature) — pass this object as-is to POST /v1/attestation/verify, or hand it to any third party to verify without trusting INVOX. Returns 404 if signing was disabled when this request was processed. Access restricted to the owning tenant.","operationId":"get_evidence_attestation_v1_evidence__request_id__attestation_get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Evidence Attestation V1 Evidence  Request Id  Attestation Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/evidence/{request_id}/report.pdf":{"get":{"summary":"Download PDF evidence report","description":"Return the PDF evidence report for a request_id. The PDF contains the validation metadata, the findings (rule id, severity, business term, location, catalogue explanation), autofix candidate fields and reproducibility info. No invoice content is included — engine messages that quote invoice values and proposed values are only in the validation response. Access restricted to the owning tenant.","operationId":"get_evidence_pdf_v1_evidence__request_id__report_pdf_get","parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"PDF evidence report","content":{"application/pdf":{}}},"404":{"description":"Evidence record or PDF not found"},"403":{"description":"Tenant access denied"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/logs":{"get":{"tags":["logs"],"summary":"List this tenant's own recent API request history","description":"Every request this tenant's API key (master or any of its sub-keys) has made recently, newest first — method, path, status code, duration, request_id, timestamp. Backed by a bounded in-memory ring buffer (recent requests only, not a permanent archive — see GET /v1/evidence for durable per-validation proof records). Use the returned request_id with GET /v1/evidence/{request_id} to pivot from 'did my request arrive and what status did it get' to the full validation result.","operationId":"list_own_request_log_v1_logs_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Own Request Log V1 Logs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/search":{"get":{"tags":["logs"],"summary":"Cross-entity search by request_id","description":"Look up a single request_id across this tenant's own request log, evidence/proof record, and webhook delivery history in one call. Every source reports found=true/false explicitly — a request_id this tenant never saw (or that belongs to a different tenant) comes back as 'not found' in every source, which is a valid, informative answer, not an error. Never partially matches or guesses.","operationId":"search_by_request_id_v1_search_get","parameters":[{"name":"request_id","in":"query","required":true,"schema":{"type":"string","title":"Request Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/mail/compose":{"post":{"summary":"Generate invoice mail template","description":"Generate a German-language email template for invoice communication. Returns subject, body, mailto_url, and a downloadable .eml file (base64). Nothing is stored server-side.","operationId":"compose_mail_v1_mail_compose_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MailComposeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MailComposeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/rules/version-as-of":{"get":{"summary":"Which ruleset version was in force on a given date (regulatory time-travel)","description":"Resolves the rule_version in force per source on a date and flags drift vs current. Invox does not re-execute archived rulesets; the signed attestation records the version actually used.","operationId":"rules_version_as_of_v1_rules_version_as_of_get","parameters":[{"name":"date","in":"query","required":true,"schema":{"type":"string","description":"ISO date, e.g. 2024-03-01","title":"Date"},"description":"ISO date, e.g. 2024-03-01"},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Rules Version As Of V1 Rules Version As Of Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/update-status":{"get":{"summary":"Automatic update-watcher status + pending regulatory changes","description":"Last automatic run and the queue of detected upstream changes awaiting governance approval.","operationId":"update_status_v1_governance_update_status_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Status V1 Governance Update Status Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/registry":{"get":{"summary":"Rule registry","description":"Return the current rule registry: active sources, versions, and rule sets.","operationId":"get_rule_registry_v1_governance_registry_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Rule Registry V1 Governance Registry Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/governance/watchers":{"get":{"summary":"Rule source watcher results","description":"Run read-only version checks against all registered rule sources. In offline mode (INVOX_WATCHER_OFFLINE=1, the default), returns cached versions. Never auto-applies updates.","operationId":"get_watcher_results_v1_governance_watchers_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Watcher Results V1 Governance Watchers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/autofix":{"post":{"summary":"Generate autofix suggestions","description":"Upload an invoice XML file and a JSON list of violations. Returns structured fix suggestions. With include_preview=true, returns a base64-encoded patched XML preview generated in RAM — never stored on the server. Supports an `Idempotency-Key` header for safe retries.","operationId":"autofix_v1_autofix_post","parameters":[{"name":"include_preview","in":"query","required":false,"schema":{"type":"boolean","description":"When true, generate an in-memory patched XML preview.","default":false,"title":"Include Preview"},"description":"When true, generate an in-memory patched XML preview."},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_autofix_v1_autofix_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AutofixResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"example":{"detail":{"error_code":"INVALID_API_KEY","message":"API key is not recognised."}}}}},"402":{"description":"Quota exhausted, or a past-due payment has passed its grace period.","content":{"application/json":{"example":{"detail":{"error_code":"QUOTA_EXCEEDED","message":"Validation quota exhausted. Purchase more credits or contact your operator.","current_usage":2000,"limit":2000}}}}},"409":{"description":"An identical request (same Idempotency-Key, or identical content when no key is supplied) is already being processed concurrently.","content":{"application/json":{"example":{"detail":{"error_code":"DUPLICATE_IN_PROGRESS","message":"An identical submission is already being processed."}}}}},"413":{"description":"Upload exceeds the endpoint's file-size limit.","content":{"application/json":{"example":{"detail":{"error_code":"FILE_TOO_LARGE","message":"File exceeds 25 MB limit"}}}}},"429":{"description":"Rate limit exceeded for this tenant (bucketed across all of the tenant's API keys, not per individual key).","content":{"application/json":{"example":{"detail":{"error_code":"RATE_LIMITED","message":"Rate limit exceeded. Retry after the window resets."}}}}},"503":{"description":"The endpoint's dependency (e.g. AI extraction, a national clearance sender) is not configured in this deployment, or is temporarily overloaded.","content":{"application/json":{"example":{"detail":{"error_code":"SYSTEM_OVERLOADED","message":"Der Validierungsdienst ist aktuell ausgelastet. Bitte in Kürze erneut versuchen."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/dedup/forget":{"post":{"summary":"Remove dedup entry (post-correction)","description":"Remove a duplicate detection entry so a corrected invoice can be re-submitted. Requires INVOX_DEDUP_ENABLED=1. Use this after the supplier has corrected and reissued the invoice.","operationId":"forget_duplicate_v1_dedup_forget_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ForgetRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Forget Duplicate V1 Dedup Forget Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/dedup/stats":{"get":{"summary":"Duplicate detection statistics","description":"Returns per-tenant duplicate detection statistics. Requires INVOX_DEDUP_ENABLED=1.","operationId":"dedup_stats_v1_dedup_stats_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Dedup Stats V1 Dedup Stats Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/deliverability":{"post":{"summary":"Will the recipient actually receive this invoice? (PEPPOL reachability + routing)","description":"Recipient-aware check on top of validation: PEPPOL participant registration (SML) + routing identifier. Fail-open (offline → 'unknown', never a false negative).","operationId":"deliverability_v1_deliverability_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_deliverability_v1_deliverability_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeliverabilityResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/convert":{"post":{"summary":"Convert an invoice to another conformant profile (re-profile + re-validate + attest)","description":"Re-profiles to ?to=xrechnung|peppol|en16931 (same UBL/CII syntax), re-validates against the target, and attests the result. Supports an `Idempotency-Key` header for safe retries.","operationId":"convert_v1_convert_post","parameters":[{"name":"to","in":"query","required":true,"schema":{"type":"string","description":"target profile ['en16931', 'peppol', 'xrechnung'] (same-syntax re-profile) or 'ubl'/'cii' (cross-syntax transform)","title":"To"},"description":"target profile ['en16931', 'peppol', 'xrechnung'] (same-syntax re-profile) or 'ubl'/'cii' (cross-syntax transform)"},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_convert_v1_convert_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConvertResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"example":{"detail":{"error_code":"INVALID_API_KEY","message":"API key is not recognised."}}}}},"402":{"description":"Quota exhausted, or a past-due payment has passed its grace period.","content":{"application/json":{"example":{"detail":{"error_code":"QUOTA_EXCEEDED","message":"Validation quota exhausted. Purchase more credits or contact your operator.","current_usage":2000,"limit":2000}}}}},"409":{"description":"An identical request (same Idempotency-Key, or identical content when no key is supplied) is already being processed concurrently.","content":{"application/json":{"example":{"detail":{"error_code":"DUPLICATE_IN_PROGRESS","message":"An identical submission is already being processed."}}}}},"413":{"description":"Upload exceeds the endpoint's file-size limit.","content":{"application/json":{"example":{"detail":{"error_code":"FILE_TOO_LARGE","message":"File exceeds 25 MB limit"}}}}},"429":{"description":"Rate limit exceeded for this tenant (bucketed across all of the tenant's API keys, not per individual key).","content":{"application/json":{"example":{"detail":{"error_code":"RATE_LIMITED","message":"Rate limit exceeded. Retry after the window resets."}}}}},"503":{"description":"The endpoint's dependency (e.g. AI extraction, a national clearance sender) is not configured in this deployment, or is temporarily overloaded.","content":{"application/json":{"example":{"detail":{"error_code":"SYSTEM_OVERLOADED","message":"Der Validierungsdienst ist aktuell ausgelastet. Bitte in Kürze erneut versuchen."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/generate":{"post":{"tags":["generate"],"summary":"Generate an XRechnung from data and prove it valid","description":"Build a conformant e-invoice from structured JSON (`invoice`) or a CSV export (`csv`) — exactly one is required. `syntax` selects UBL (default) or CII/ZUGFeRD output. The generated document is immediately run through the same certified validator as /v1/validate and returned with its verdict and signed attestation, so a generation that would fail conformance is surfaced honestly rather than silently returned as if it were valid. Supports an `Idempotency-Key` header for safe retries.","operationId":"generate_v1_generate_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"example":{"detail":{"error_code":"INVALID_API_KEY","message":"API key is not recognised."}}}}},"402":{"description":"Quota exhausted, or a past-due payment has passed its grace period.","content":{"application/json":{"example":{"detail":{"error_code":"QUOTA_EXCEEDED","message":"Validation quota exhausted. Purchase more credits or contact your operator.","current_usage":2000,"limit":2000}}}}},"409":{"description":"An identical request (same Idempotency-Key, or identical content when no key is supplied) is already being processed concurrently.","content":{"application/json":{"example":{"detail":{"error_code":"DUPLICATE_IN_PROGRESS","message":"An identical submission is already being processed."}}}}},"413":{"description":"Upload exceeds the endpoint's file-size limit.","content":{"application/json":{"example":{"detail":{"error_code":"FILE_TOO_LARGE","message":"File exceeds 25 MB limit"}}}}},"429":{"description":"Rate limit exceeded for this tenant (bucketed across all of the tenant's API keys, not per individual key).","content":{"application/json":{"example":{"detail":{"error_code":"RATE_LIMITED","message":"Rate limit exceeded. Retry after the window resets."}}}}},"503":{"description":"The endpoint's dependency (e.g. AI extraction, a national clearance sender) is not configured in this deployment, or is temporarily overloaded.","content":{"application/json":{"example":{"detail":{"error_code":"SYSTEM_OVERLOADED","message":"Der Validierungsdienst ist aktuell ausgelastet. Bitte in Kürze erneut versuchen."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/generate/batch":{"post":{"tags":["generate"],"summary":"Generate multiple XRechnungen in one request","description":"Submit up to INVOX_GENERATE_BATCH_MAX_SIZE (default 50) invoice payloads in one call — the bulk counterpart of /v1/generate for an ERP's nightly invoice run. Each item is generated and validated exactly as /v1/generate would, independently: one item's failure (bad input, quota exhaustion, engine crash) never aborts the rest of the batch — check each result's `success` field. Results are returned in submission order. Supports an `Idempotency-Key` header for the whole batch — a retry is not charged again; because no invoice content is retained, the items are regenerated for the retry.","operationId":"generate_batch_v1_generate_batch_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateBatchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerateBatchResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"example":{"detail":{"error_code":"INVALID_API_KEY","message":"API key is not recognised."}}}}},"402":{"description":"Quota exhausted, or a past-due payment has passed its grace period.","content":{"application/json":{"example":{"detail":{"error_code":"QUOTA_EXCEEDED","message":"Validation quota exhausted. Purchase more credits or contact your operator.","current_usage":2000,"limit":2000}}}}},"409":{"description":"An identical request (same Idempotency-Key, or identical content when no key is supplied) is already being processed concurrently.","content":{"application/json":{"example":{"detail":{"error_code":"DUPLICATE_IN_PROGRESS","message":"An identical submission is already being processed."}}}}},"413":{"description":"Upload exceeds the endpoint's file-size limit.","content":{"application/json":{"example":{"detail":{"error_code":"FILE_TOO_LARGE","message":"File exceeds 25 MB limit"}}}}},"429":{"description":"Rate limit exceeded for this tenant (bucketed across all of the tenant's API keys, not per individual key).","content":{"application/json":{"example":{"detail":{"error_code":"RATE_LIMITED","message":"Rate limit exceeded. Retry after the window resets."}}}}},"503":{"description":"The endpoint's dependency (e.g. AI extraction, a national clearance sender) is not configured in this deployment, or is temporarily overloaded.","content":{"application/json":{"example":{"detail":{"error_code":"SYSTEM_OVERLOADED","message":"Der Validierungsdienst ist aktuell ausgelastet. Bitte in Kürze erneut versuchen."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/extract":{"post":{"tags":["extract"],"summary":"Extract a PDF invoice, then generate+validate+attest","description":"Upload a PDF or scanned invoice. Fields are extracted via embedded-XML parsing or offline deterministic regex+checksum extraction first (no third party involved), falling back to AI (Anthropic, US sub-processor — see `sub_processor` in the response) only when configured and needed, mapped to EN16931 terms, then closed-loop generated+validated the same way as /v1/generate. Supports an `Idempotency-Key` header — a retry is not charged again; because no invoice content is retained, the extraction is re-run for the retry (at most 3 free replays per key, then 409 IDEMPOTENCY_REPLAY_LIMIT — send a new key).","operationId":"extract_v1_extract_post","parameters":[{"name":"syntax","in":"query","required":false,"schema":{"type":"string","default":"ubl","title":"Syntax"}},{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_extract_v1_extract_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"example":{"detail":{"error_code":"INVALID_API_KEY","message":"API key is not recognised."}}}}},"402":{"description":"Quota exhausted, or a past-due payment has passed its grace period.","content":{"application/json":{"example":{"detail":{"error_code":"QUOTA_EXCEEDED","message":"Validation quota exhausted. Purchase more credits or contact your operator.","current_usage":2000,"limit":2000}}}}},"409":{"description":"An identical request (same Idempotency-Key, or identical content when no key is supplied) is already being processed concurrently.","content":{"application/json":{"example":{"detail":{"error_code":"DUPLICATE_IN_PROGRESS","message":"An identical submission is already being processed."}}}}},"413":{"description":"Upload exceeds the endpoint's file-size limit.","content":{"application/json":{"example":{"detail":{"error_code":"FILE_TOO_LARGE","message":"File exceeds 25 MB limit"}}}}},"429":{"description":"Rate limit exceeded for this tenant (bucketed across all of the tenant's API keys, not per individual key).","content":{"application/json":{"example":{"detail":{"error_code":"RATE_LIMITED","message":"Rate limit exceeded. Retry after the window resets."}}}}},"503":{"description":"The endpoint's dependency (e.g. AI extraction, a national clearance sender) is not configured in this deployment, or is temporarily overloaded.","content":{"application/json":{"example":{"detail":{"error_code":"SYSTEM_OVERLOADED","message":"Der Validierungsdienst ist aktuell ausgelastet. Bitte in Kürze erneut versuchen."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/transmit":{"post":{"summary":"Prepare a PEPPOL transmission (SBDH + SMP routing) with a signed proof","description":"Validate → resolve Access Point (SMP) → SBDH envelope → send (pluggable AP; default package-only) → signed transmission proof. XML or ZUGFeRD PDF. Zero-retention. Supports an `Idempotency-Key` header — a retried request with the same key replays the original signed proof instead of re-delivering to the Access Point; without the header, a content-hash fallback still catches an identical resubmission. The SBDH envelope (the invoice itself) is not retained: `sbdh_base64` is null on a replay.","operationId":"transmit_v1_transmit_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_transmit_v1_transmit_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransmitResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/transmit/batch":{"post":{"summary":"Prepare multiple PEPPOL transmissions in one request","description":"Submit up to INVOX_TRANSMIT_BATCH_MAX_SIZE (default 20 — smaller than /v1/generate/batch's cap because each item does a real SMP lookup and Access Point send, not pure in-memory work) already-generated invoice documents as base64 — the bulk counterpart of /v1/transmit for an ERP dispatching a nightly run of outbound invoices. Each item is validated → resolved (SMP) → wrapped in an SBDH → sent, exactly as /v1/transmit would, independently: one item's failure never aborts the rest of the batch — check each result's `prepared` field. Results are returned in submission order. XML or ZUGFeRD PDF per item. Zero-retention. Supports an `Idempotency-Key` header for the whole batch — a retry replays the cached result for every item instead of re-delivering any of them; without the header, a content-hash fallback still catches an identical resubmission. The SBDH envelope (the invoice itself) is not retained: `sbdh_base64` is null on a replay.","operationId":"transmit_batch_v1_transmit_batch_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransmitBatchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransmitBatchResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/inbound":{"post":{"tags":["inbound"],"summary":"Receive an inbound e-invoice and return a signed reception proof","description":"The inbound counterpart to /v1/transmit: a certified partner Access Point (or any delivery channel) posts a PEPPOL payload here. Supports an `Idempotency-Key` header — recommended, since a partner AP's own delivery-retry semantics (e.g. PEPPOL AS4) commonly re-POST after a lost ack, which without this would double-count the reception proof.","operationId":"inbound_v1_inbound_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_inbound_v1_inbound_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"example":{"detail":{"error_code":"INVALID_API_KEY","message":"API key is not recognised."}}}}},"402":{"description":"Quota exhausted, or a past-due payment has passed its grace period.","content":{"application/json":{"example":{"detail":{"error_code":"QUOTA_EXCEEDED","message":"Validation quota exhausted. Purchase more credits or contact your operator.","current_usage":2000,"limit":2000}}}}},"409":{"description":"An identical request (same Idempotency-Key, or identical content when no key is supplied) is already being processed concurrently.","content":{"application/json":{"example":{"detail":{"error_code":"DUPLICATE_IN_PROGRESS","message":"An identical submission is already being processed."}}}}},"413":{"description":"Upload exceeds the endpoint's file-size limit.","content":{"application/json":{"example":{"detail":{"error_code":"FILE_TOO_LARGE","message":"File exceeds 25 MB limit"}}}}},"429":{"description":"Rate limit exceeded for this tenant (bucketed across all of the tenant's API keys, not per individual key).","content":{"application/json":{"example":{"detail":{"error_code":"RATE_LIMITED","message":"Rate limit exceeded. Retry after the window resets."}}}}},"503":{"description":"The endpoint's dependency (e.g. AI extraction, a national clearance sender) is not configured in this deployment, or is temporarily overloaded.","content":{"application/json":{"example":{"detail":{"error_code":"SYSTEM_OVERLOADED","message":"Der Validierungsdienst ist aktuell ausgelastet. Bitte in Kürze erneut versuchen."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/storecove/webhook":{"post":{"tags":["inbound"],"summary":"Receive a Storecove-delivered inbound document (webhook)","operationId":"storecove_webhook_v1_storecove_webhook_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InboundResponse"}}}}}}},"/v1/ksef/send":{"post":{"tags":["transmit"],"summary":"Clear a Polish invoice through KSeF with a signed clearance proof","operationId":"ksef_send_v1_ksef_send_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_ksef_send_v1_ksef_send_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KsefResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/sdi/send":{"post":{"tags":["transmit"],"summary":"Clear an Italian invoice through SDI with a signed clearance proof","operationId":"sdi_send_v1_sdi_send_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_sdi_send_v1_sdi_send_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SdiResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/choruspro/send":{"post":{"tags":["transmit"],"summary":"Deposit a French invoice to Chorus Pro with a signed clearance proof","operationId":"choruspro_send_v1_choruspro_send_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_choruspro_send_v1_choruspro_send_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChorusProResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/face/send":{"post":{"tags":["transmit"],"summary":"Register a Spanish invoice with FACe with a signed clearance proof","operationId":"face_send_v1_face_send_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_face_send_v1_face_send_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FaceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verifactu/register":{"post":{"tags":["transmit"],"summary":"Register a Spanish invoice under VeriFactu (hash chain + QR + signed attestation)","description":"Builds the official RegistroAlta record, chains it to the emisor's previous record, generates the mandatory QR content, and adds a signed attestation. Optional `submit=true` also transmits to AEAT in real time. Supports an `Idempotency-Key` header — critical here, since a duplicate registration wouldn't just double-charge but double-file a legal tax record and corrupt the AEAT-mandated hash chain.","operationId":"verifactu_register_v1_verifactu_register_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifactuRegisterRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifactuRegisterResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"example":{"detail":{"error_code":"INVALID_API_KEY","message":"API key is not recognised."}}}}},"402":{"description":"Quota exhausted, or a past-due payment has passed its grace period.","content":{"application/json":{"example":{"detail":{"error_code":"QUOTA_EXCEEDED","message":"Validation quota exhausted. Purchase more credits or contact your operator.","current_usage":2000,"limit":2000}}}}},"409":{"description":"An identical request (same Idempotency-Key, or identical content when no key is supplied) is already being processed concurrently.","content":{"application/json":{"example":{"detail":{"error_code":"DUPLICATE_IN_PROGRESS","message":"An identical submission is already being processed."}}}}},"503":{"description":"The endpoint's dependency (e.g. AI extraction, a national clearance sender) is not configured in this deployment, or is temporarily overloaded.","content":{"application/json":{"example":{"detail":{"error_code":"SYSTEM_OVERLOADED","message":"Der Validierungsdienst ist aktuell ausgelastet. Bitte in Kürze erneut versuchen."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/verifactu/chain/verify":{"get":{"tags":["transmit"],"summary":"Independently re-verify a VeriFactu chain's integrity for one NIF","operationId":"verifactu_verify_chain_v1_verifactu_chain_verify_get","parameters":[{"name":"nif","in":"query","required":true,"schema":{"type":"string","title":"Nif"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerifactuChainVerifyResponse"}}}},"401":{"description":"Missing or invalid API key.","content":{"application/json":{"example":{"detail":{"error_code":"INVALID_API_KEY","message":"API key is not recognised."}}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/mydata/send":{"post":{"tags":["transmit"],"summary":"Report a Greek invoice through AADE myDATA with a signed clearance proof","operationId":"mydata_send_v1_mydata_send_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_mydata_send_v1_mydata_send_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MyDataResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/nav/report":{"post":{"tags":["transmit"],"summary":"Report a Hungarian invoice to NAV Online Számla with a signed clearance proof","operationId":"nav_report_v1_nav_report_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_nav_report_v1_nav_report_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NavResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/efactura/send":{"post":{"tags":["transmit"],"summary":"Submit a Romanian invoice to ANAF e-Factura with a signed clearance proof","operationId":"efactura_send_v1_efactura_send_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_efactura_send_v1_efactura_send_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EfacturaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/fiskalizacija/send":{"post":{"tags":["transmit"],"summary":"Register a Croatian invoice with Fiskalizacija 2.0 with a signed clearance proof","operationId":"fiskalizacija_send_v1_fiskalizacija_send_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_fiskalizacija_send_v1_fiskalizacija_send_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FiskalizacijaResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/atcud/send":{"post":{"tags":["transmit"],"summary":"Register a Portuguese invoice for ATCUD/SAF-T(PT) with a signed clearance proof","operationId":"atcud_send_v1_atcud_send_post","parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency-Key"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_atcud_send_v1_atcud_send_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AtcudResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/validate/draft":{"post":{"summary":"Fast edit-time draft validation (native only, no KoSIT)","description":"Millisecond pre-check for live editing. Tolerates incomplete invoices. NOT the binding verdict — use /v1/validate for that.","operationId":"validate_draft_v1_validate_draft_post","parameters":[{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_validate_draft_v1_validate_draft_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/explain":{"post":{"summary":"Humanize validation violations","description":"Convert technical rule violations into German-language human-readable messages. Always preserves the technical_ref for traceability.","operationId":"explain_violations_v1_explain_post","parameters":[{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Language of the guidance (de, en). Defaults to Accept-Language, then de.","title":"Lang"},"description":"Language of the guidance (de, en). Defaults to Accept-Language, then de."},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExplainRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExplainResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/rules/{rule_id}/why":{"get":{"summary":"Why does this rule exist? (regulatory/standards basis + rationale)","description":"Returns the standard/legal source and a plain-language reason for a validation rule.","operationId":"rule_why_v1_rules__rule_id__why_get","parameters":[{"name":"rule_id","in":"path","required":true,"schema":{"type":"string","title":"Rule Id"}},{"name":"lang","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lang"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WhyOut"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/branding":{"get":{"summary":"White-label branding config","description":"Returns branding configuration (name, logo, accent colour). No authentication required for the global default. Pass X-API-Key to get that tenant's own custom branding if they've set one (Business plan, via POST /v1/branding).","operationId":"get_branding_v1_branding_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Branding V1 Branding Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]},"post":{"summary":"Set this tenant's white-label branding (Business plan)","description":"Self-serve white-label config: product name, logo, accent colour, favicon, tagline. Applied to this tenant's PDF evidence reports and GET /v1/branding when called with this tenant's API key. Requires the Business plan.","operationId":"set_branding_v1_branding_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetBrandingRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Branding V1 Branding Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/compliance/mandates":{"get":{"tags":["compliance"],"summary":"List countries with encoded e-invoicing mandate data","operationId":"list_mandates_v1_compliance_mandates_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Mandates V1 Compliance Mandates Get"}}}}}}},"/v1/compliance/mandate/{country}":{"get":{"tags":["compliance"],"summary":"E-invoicing obligation for a country","operationId":"get_mandate_v1_compliance_mandate__country__get","parameters":[{"name":"country","in":"path","required":true,"schema":{"type":"string","title":"Country"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Mandate V1 Compliance Mandate  Country  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks":{"post":{"tags":["webhooks"],"summary":"Register a webhook endpoint","description":"Register a webhook endpoint for the current tenant.","operationId":"register_webhook_v1_webhooks_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookCreateRequest"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]},"get":{"tags":["webhooks"],"summary":"List webhooks for the current tenant","description":"Return all active webhooks for the current tenant (secrets masked).","operationId":"list_webhooks_v1_webhooks_get","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/WebhookResponse"},"title":"Response List Webhooks V1 Webhooks Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/webhooks/{webhook_id}/deliveries":{"get":{"tags":["webhooks"],"summary":"Recent delivery attempts for one webhook","description":"Most recent delivery attempts for this webhook (successes, retries still\npending, and dead-lettered failures), newest first — including test-sends\nand replays, each flagged via `is_test` / `replayed_from_delivery_id`.\n\nTenant-scoped like every other route here: 404 if the webhook does not\nexist or is not owned by the calling tenant, so this can never be used to\nenumerate another tenant's delivery history by guessing a webhook_id.","operationId":"list_webhook_deliveries_v1_webhooks__webhook_id__deliveries_get","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DeliveryLogEntry"},"title":"Response List Webhook Deliveries V1 Webhooks  Webhook Id  Deliveries Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/webhooks/{webhook_id}":{"delete":{"tags":["webhooks"],"summary":"Delete a webhook","description":"Delete a webhook. Returns 404 if not found or not owned by this tenant.","operationId":"delete_webhook_v1_webhooks__webhook_id__delete","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"204":{"description":"Successful Response"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/webhooks/{webhook_id}/test":{"post":{"tags":["webhooks"],"summary":"Send a synthetic test event to a registered webhook","description":"Dispatch a synthetic `webhook.test` event to one registered endpoint\non demand, signed and delivered through the exact same path as a real\nevent (invox.webhooks.sender), and logged in the delivery history like a\nreal delivery so it shows up in the same place a customer already looks\nwhen debugging their integration.\n\nTenant-scoped like every other route here: 404 if the webhook does not\nexist or is not owned by the calling tenant — a tenant can never probe\nanother tenant's endpoint through this route.\n\nDeliberately bypasses the circuit breaker: the whole point of a test\nbutton is to let a customer probe an endpoint they suspect is broken\n(that's exactly the state the breaker's \"open\" means) without waiting\nout the breaker's open window. Rate-limited by a short per-webhook\ncooldown instead (see _check_test_send_cooldown) — the circuit-breaker\nbypass plus the generic per-key request-rate limit alone would let this\nbutton be used to drive a sustained stream of requests at any endpoint a\ntenant can register, not just an occasional manual probe.","operationId":"test_webhook_v1_webhooks__webhook_id__test_post","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string","title":"Webhook Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookTestResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/webhooks/deliveries/{delivery_id}/replay":{"post":{"tags":["webhooks"],"summary":"Re-send a past webhook delivery by its delivery id","description":"Re-send the exact original payload of a past delivery-log entry to\nthe same endpoint it originally targeted, through the normal signed\nsender path. Creates a brand-new delivery-log entry linked back to the\noriginal via `replayed_from_delivery_id` — the original record is never\nmutated or duplicated in place.\n\nTenant-scoped: 404 (not 403, to avoid confirming another tenant's\ndelivery id exists) if the delivery record does not exist, does not\nbelong to the calling tenant, or its webhook has since been deleted /\nis no longer owned by this tenant.\n\nUnlike test-send, a replay DOES respect the circuit breaker — from the\nreceiving endpoint's perspective a replay is indistinguishable from a\nfresh delivery of that event, so an endpoint with an open circuit fails\nthe replay fast instead of being hammered by a customer retrying a\nbatch of past failures.","operationId":"replay_webhook_delivery_v1_webhooks_deliveries__delivery_id__replay_post","parameters":[{"name":"delivery_id","in":"path","required":true,"schema":{"type":"string","title":"Delivery Id"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookReplayResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKeyAuth":[]}]}},"/v1/portfolio/metrics":{"get":{"summary":"Operational KPIs for the FORGE Portfolio-HQ aggregator","description":"Aggregate, non-sensitive usage counts. No authentication required.","operationId":"portfolio_metrics_v1_portfolio_metrics_get","parameters":[{"name":"x-invox-metrics-token","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Invox-Metrics-Token"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Portfolio Metrics V1 Portfolio Metrics Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/login":{"post":{"tags":["auth"],"summary":"Login","operationId":"login_v1_auth_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/2fa/verify-login":{"post":{"tags":["auth"],"summary":"Verify 2Fa Login","description":"Second step of login when 2FA is enabled: exchange the pending token +\na correct TOTP/backup code for a real session. Same per-IP rate limit as\n/login — a 6-digit code has a small enough space that unlimited guesses\nwould matter, but the login lockout (5 attempts/15min) already makes\nbrute-forcing it impractical.","operationId":"verify_2fa_login_v1_auth_2fa_verify_login_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorVerifyLoginRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/2fa/setup":{"post":{"tags":["auth"],"summary":"Setup 2Fa","description":"Step 1: generate a new secret and return it (as an otpauth:// URI for\nQR/manual entry). Does NOT enable 2FA yet — see /2fa/confirm. Calling this\nagain before confirming simply replaces the pending secret, so an\nabandoned setup attempt can never linger as a stale, unconfirmed secret\nthat later gets confirmed by mistake with an old code.","operationId":"setup_2fa_v1_auth_2fa_setup_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorSetupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/2fa/confirm":{"post":{"tags":["auth"],"summary":"Confirm 2Fa","description":"Step 2: prove possession of the authenticator app with a correct code\nbefore 2FA actually protects the account. Issues one-time backup codes —\nshown exactly once, like a freshly minted API key.","operationId":"confirm_2fa_v1_auth_2fa_confirm_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorConfirmRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorConfirmResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/2fa/disable":{"post":{"tags":["auth"],"summary":"Disable 2Fa","description":"Requires re-entering the password — same discipline as account\ndeletion: disabling the second factor is exactly the kind of action a\nstolen/left-open session must not be able to do with one click.","operationId":"disable_2fa_v1_auth_2fa_disable_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TwoFactorDisableRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/logout":{"post":{"tags":["auth"],"summary":"Logout","operationId":"logout_v1_auth_logout_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/sessions":{"get":{"tags":["auth"],"summary":"List Sessions","operationId":"list_sessions_v1_auth_sessions_get","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SessionOut"},"title":"Response List Sessions V1 Auth Sessions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/sessions/{session_id}":{"delete":{"tags":["auth"],"summary":"Revoke Session","operationId":"revoke_session_v1_auth_sessions__session_id__delete","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"integer","title":"Session Id"}},{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/sessions/revoke-others":{"post":{"tags":["auth"],"summary":"Revoke Other Sessions","description":"'Sign out everywhere else' — keeps the CALLER's own session alive\n(unlike delete-account's full delete_user_sessions), for the case where\nthe user only wants to kick out a device they no longer recognize.","operationId":"revoke_other_sessions_v1_auth_sessions_revoke_others_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/me":{"get":{"tags":["auth"],"summary":"Me","operationId":"me_v1_auth_me_get","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/invox__api__routes__auth_portal__MeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/portal/pdf-language":{"post":{"tags":["auth"],"summary":"Set Pdf Language","operationId":"set_pdf_language_v1_auth_portal_pdf_language_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetPdfLanguageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/invox__api__routes__auth_portal__MeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/activity":{"get":{"tags":["auth"],"summary":"Get Activity","description":"The account-level counterpart to the evidence hash-chain (which covers\ninvoice validation, not account settings). Lets the owner notice, after\nthe fact, security-sensitive actions they didn't take themselves — e.g. a\nstolen password used to quietly disable 2FA before the owner re-enables it.\n\nlimit/offset (2026-08): a very active account (frequent logins/key\nrotations) previously had older-but-still-retained events permanently\nunreachable through this endpoint — undermining the panel's own promise.","operationId":"get_activity_v1_auth_activity_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":200,"minimum":1,"default":50,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0,"title":"Offset"}},{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ActivityOut"},"title":"Response Get Activity V1 Auth Activity Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/delete-account":{"post":{"tags":["auth"],"summary":"Delete Account","description":"DSGVO Art. 17 self-service erasure (2026-08) — anonymizes rather than hard-\ndeletes; see auth_db.anonymize_user_account for why (§147 AO / §257 HGB\nretention duty on the same billing/audit data this account touched). Requires\nre-entering the password (not just an active session) before an irreversible\naction, same pattern any real account-deletion flow should use.","operationId":"delete_account_v1_auth_delete_account_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeleteAccountRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/request-password-reset":{"post":{"tags":["auth"],"summary":"Request Password Reset","operationId":"request_password_reset_v1_auth_request_password_reset_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequestPasswordResetRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/reset-password":{"post":{"tags":["auth"],"summary":"Reset Password","operationId":"reset_password_v1_auth_reset_password_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResetPasswordRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/portal/api-keys":{"post":{"tags":["auth"],"summary":"Create Api Key","operationId":"create_api_key_v1_auth_portal_api_keys_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["auth"],"summary":"List Api Keys","operationId":"list_api_keys_v1_auth_portal_api_keys_get","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/portal/api-keys/{key_id}":{"delete":{"tags":["auth"],"summary":"Revoke Api Key","operationId":"revoke_api_key_v1_auth_portal_api_keys__key_id__delete","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"integer","title":"Key Id"}},{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/portal/sandbox-key":{"post":{"tags":["auth"],"summary":"Create Sandbox Key","description":"A sandbox key runs against the real KoSIT/phive validation engines (a real\nintegration test, not a mock) but is rejected by every endpoint except\nPOST /v1/validate (require_api_key_sandbox_ok in api/auth.py), never\ntouches quota/billing, and produces no signed evidence/attestation (see\nvalidate.py's sandbox branch). Capped per tenant since sandbox keys bypass\nthe natural quota throttle — unbounded creation would itself be an abuse\nvector.","operationId":"create_sandbox_key_v1_auth_portal_sandbox_key_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateApiKeyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/register":{"post":{"tags":["auth"],"summary":"Register","description":"Self-service registration. Creates the first admin user for a new tenant. No invite code is needed while open registration is active; otherwise a valid `registration_code` is required. Either `vat_id` or `tax_number` must also be provided (422 TAX_IDENTITY_REQUIRED otherwise) to identify the registering company. Duplicate email/tenant returns 409.","operationId":"register_v1_auth_register_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterRequest"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/webauthn/register/options":{"post":{"tags":["webauthn"],"summary":"Webauthn Register Options","operationId":"webauthn_register_options_v1_auth_webauthn_register_options_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterOptionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/webauthn/register/verify":{"post":{"tags":["webauthn"],"summary":"Webauthn Register Verify","operationId":"webauthn_register_verify_v1_auth_webauthn_register_verify_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterVerifyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterVerifyResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/webauthn/login/options":{"post":{"tags":["webauthn"],"summary":"Webauthn Login Options","operationId":"webauthn_login_options_v1_auth_webauthn_login_options_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginOptionsRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginOptionsResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/webauthn/login/verify":{"post":{"tags":["webauthn"],"summary":"Webauthn Login Verify","operationId":"webauthn_login_verify_v1_auth_webauthn_login_verify_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoginVerifyRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/webauthn/credentials":{"get":{"tags":["webauthn"],"summary":"Webauthn List Credentials","operationId":"webauthn_list_credentials_v1_auth_webauthn_credentials_get","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CredentialSummary"},"title":"Response Webauthn List Credentials V1 Auth Webauthn Credentials Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/webauthn/credentials/{credential_row_id}":{"delete":{"tags":["webauthn"],"summary":"Webauthn Delete Credential","operationId":"webauthn_delete_credential_v1_auth_webauthn_credentials__credential_row_id__delete","parameters":[{"name":"credential_row_id","in":"path","required":true,"schema":{"type":"integer","title":"Credential Row Id"}},{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/auth/saml/config":{"post":{"tags":["saml"],"summary":"Set Saml Config","description":"Tenant-scoped by construction: admin[\"tenant_id\"] only, never a\ncaller-supplied tenant id — same BOLA/BFLA discipline as every other\ntenant-scoped write in auth_portal.py (e.g. create_user).","operationId":"set_saml_config_v1_auth_saml_config_post","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamlConfigRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SamlConfigResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["saml"],"summary":"Get Saml Config","operationId":"get_saml_config_v1_auth_saml_config_get","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SamlConfigResponse"},{"type":"null"}],"title":"Response Get Saml Config V1 Auth Saml Config Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["saml"],"summary":"Delete Saml Config","operationId":"delete_saml_config_v1_auth_saml_config_delete","parameters":[{"name":"session","in":"cookie","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ActivityOut":{"properties":{"event_type":{"type":"string","title":"Event Type"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"},"created_at":{"type":"string","title":"Created At"}},"type":"object","required":["event_type","ip_address","user_agent","created_at"],"title":"ActivityOut"},"AssistantRequest":{"properties":{"question":{"type":"string","maxLength":2000,"title":"Question"},"lang":{"type":"string","title":"Lang","default":"de"},"email":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Email"},"retention_count":{"type":"integer","maximum":20.0,"minimum":0.0,"title":"Retention Count","default":0},"context":{"type":"string","maxLength":2000,"title":"Context","default":""}},"type":"object","required":["question"],"title":"AssistantRequest"},"AtcudResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"atcud_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Atcud Code"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"outbound_check":{"type":"string","enum":["passed","blocked"],"title":"Outbound Check","description":"Outbound validation gate result.","default":"blocked"},"invoice_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Hash"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this operation — also embedded in `proof` (when present) and in INVOX's own logs/audit trail for this request."}},"type":"object","required":["accepted","detail"],"title":"AtcudResponse"},"AutofixResponse":{"properties":{"suggestions":{"items":{"$ref":"#/components/schemas/AutofixSuggestionOut"},"type":"array","title":"Suggestions"},"fixable_count":{"type":"integer","title":"Fixable Count"},"manual_count":{"type":"integer","title":"Manual Count"},"patched_xml_preview_b64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patched Xml Preview B64","description":"Base64-encoded preview of the XML with fixable suggestions applied. Only present when include_preview=true. IMPORTANT: This is a rough preview — validate before use. Not stored anywhere by the server."},"patched_xml_filename":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Patched Xml Filename"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"type":"object","required":["suggestions","fixable_count","manual_count"],"title":"AutofixResponse"},"AutofixSuggestionOut":{"properties":{"rule_id":{"type":"string","title":"Rule Id"},"field_label":{"type":"string","title":"Field Label"},"bt_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bt Number"},"xpath":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Xpath"},"proposed_value":{"type":"string","title":"Proposed Value"},"proposed_snippet":{"type":"string","title":"Proposed Snippet"},"auto_fix_possible":{"type":"boolean","title":"Auto Fix Possible"},"reason":{"type":"string","title":"Reason"},"prevalence":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Prevalence","description":"Real-world fail-rate of this rule for the detected format, from anonymised cross-tenant statistics (k-anonymised; null if too rare to expose). Suggestions are ordered by prevalence so the most common issues come first."}},"type":"object","required":["rule_id","field_label","bt_number","xpath","proposed_value","proposed_snippet","auto_fix_possible","reason"],"title":"AutofixSuggestionOut"},"BatchValidationResult":{"properties":{"batch_id":{"type":"string","title":"Batch Id","description":"UUID identifying this batch request."},"total":{"type":"integer","title":"Total","description":"Total number of files submitted."},"valid_count":{"type":"integer","title":"Valid Count","description":"Number of files with verdict='valid'."},"invalid_count":{"type":"integer","title":"Invalid Count","description":"Number of files with verdict='invalid'."},"failed_count":{"type":"integer","title":"Failed Count","description":"Number of files that failed to process (engine crash, security block, etc.)."},"results":{"items":{"$ref":"#/components/schemas/ValidationResult"},"type":"array","title":"Results","description":"Per-file ValidationResult objects, in submission order."},"processing_ms":{"type":"integer","title":"Processing Ms","description":"Total wall-clock processing time in milliseconds.","default":0},"sandbox":{"type":"boolean","title":"Sandbox","description":"True if this batch ran with a sandbox API key: real validation engines, real verdicts, but zero quota/billing/evidence footprint per file (see per-file ValidationResult.sandbox) and a shared daily volume cap across sandbox endpoints.","default":false}},"type":"object","required":["batch_id","total","valid_count","invalid_count","failed_count"],"title":"BatchValidationResult","description":"Result of a batch validation request (multiple invoices in one call)."},"Body_atcud_send_v1_atcud_send_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_atcud_send_v1_atcud_send_post"},"Body_autofix_v1_autofix_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"violations_json":{"type":"string","title":"Violations Json","description":"JSON array of Violation objects (same format as /v1/validate response)."}},"type":"object","required":["file","violations_json"],"title":"Body_autofix_v1_autofix_post"},"Body_choruspro_send_v1_choruspro_send_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_choruspro_send_v1_choruspro_send_post"},"Body_convert_v1_convert_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_convert_v1_convert_post"},"Body_deliverability_v1_deliverability_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_deliverability_v1_deliverability_post"},"Body_efactura_send_v1_efactura_send_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_efactura_send_v1_efactura_send_post"},"Body_export_datev_v1_export_datev_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files"},"consultant_number":{"type":"integer","title":"Consultant Number","description":"DATEV Beraternummer."},"client_number":{"type":"integer","title":"Client Number","description":"DATEV Mandantennummer."},"fiscal_year_start":{"type":"string","title":"Fiscal Year Start","description":"Fiscal year start, YYYYMMDD."},"period_from":{"type":"string","title":"Period From","description":"Booking period start, YYYYMMDD."},"period_to":{"type":"string","title":"Period To","description":"Booking period end, YYYYMMDD."},"sachkonten_length":{"type":"integer","title":"Sachkonten Length","description":"Sachkonten-Nummernlänge (4-8).","default":4},"debtor_account":{"type":"integer","title":"Debtor Account","description":"Debitor account to debit (Konto).","default":10000},"description":{"type":"string","title":"Description","description":"Batch description (max 30 chars).","default":"Ausgangsrechnungen"}},"type":"object","required":["files","consultant_number","client_number","fiscal_year_start","period_from","period_to"],"title":"Body_export_datev_v1_export_datev_post"},"Body_extract_v1_extract_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_extract_v1_extract_post"},"Body_face_send_v1_face_send_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_face_send_v1_face_send_post"},"Body_fiskalizacija_send_v1_fiskalizacija_send_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_fiskalizacija_send_v1_fiskalizacija_send_post"},"Body_inbound_v1_inbound_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_inbound_v1_inbound_post"},"Body_ksef_send_v1_ksef_send_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_ksef_send_v1_ksef_send_post"},"Body_mydata_send_v1_mydata_send_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_mydata_send_v1_mydata_send_post"},"Body_nav_report_v1_nav_report_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_nav_report_v1_nav_report_post"},"Body_reconcile_context_v1_references_reconcile_context_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"context_file":{"type":"string","contentMediaType":"application/octet-stream","title":"Context File","description":"UTF-8 JSON or CSV ERP/P2P reference export"}},"type":"object","required":["file","context_file"],"title":"Body_reconcile_context_v1_references_reconcile_context_post"},"Body_reconcile_v1_references_reconcile_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"references_json":{"type":"string","title":"References Json","description":"JSON object, for example {\"BT-10\":\"buyer-ref\",\"BT-12\":\"contract-42\",\"BT-13\":\"PO-7\",\"BT-16\":\"DN-9\"}"}},"type":"object","required":["file","references_json"],"title":"Body_reconcile_v1_references_reconcile_post"},"Body_remediate_v1_remediate_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_remediate_v1_remediate_post"},"Body_report_drr_v1_report_drr_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_report_drr_v1_report_drr_post"},"Body_sdi_send_v1_sdi_send_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_sdi_send_v1_sdi_send_post"},"Body_transmit_v1_transmit_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_transmit_v1_transmit_post"},"Body_validate_batch_v1_validate_batch_post":{"properties":{"files":{"items":{"type":"string","contentMediaType":"application/octet-stream"},"type":"array","title":"Files"}},"type":"object","required":["files"],"title":"Body_validate_batch_v1_validate_batch_post"},"Body_validate_draft_v1_validate_draft_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_validate_draft_v1_validate_draft_post"},"Body_validate_invoice_v1_validate_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_validate_invoice_v1_validate_post"},"ChorusProResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"numero_flux_depot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Numero Flux Depot"},"date_depot":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Date Depot"},"syntaxe":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Syntaxe"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"outbound_check":{"type":"string","enum":["passed","blocked"],"title":"Outbound Check","description":"Outbound validation gate result.","default":"blocked"},"invoice_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Hash"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this operation — also embedded in `proof` (when present) and in INVOX's own logs/audit trail for this request."}},"type":"object","required":["accepted","detail"],"title":"ChorusProResponse"},"ContactRequest":{"properties":{"name":{"type":"string","maxLength":120,"minLength":1,"title":"Name"},"email":{"type":"string","maxLength":200,"minLength":3,"title":"Email"},"message":{"type":"string","maxLength":5000,"minLength":10,"title":"Message"},"company":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Company"},"category":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Category"},"website":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Website"},"consent":{"type":"boolean","title":"Consent","default":false}},"type":"object","required":["name","email","message"],"title":"ContactRequest"},"ContextReconcileResponse":{"properties":{"assessed":{"type":"boolean","title":"Assessed"},"all_expected_match":{"type":"boolean","title":"All Expected Match"},"reference_presence":{"anyOf":[{"additionalProperties":{"type":"boolean"},"type":"object"},{"type":"null"}],"title":"Reference Presence"},"results":{"additionalProperties":{"additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"string"}]},"type":"object"},"type":"object","title":"Results"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"content_retained":{"type":"boolean","title":"Content Retained","description":"Always false: invoice bytes and reference values are not persisted.","default":false},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"},"context_source":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Context Source","description":"Input format used for the ephemeral ERP/P2P context: json or csv."}},"type":"object","required":["assessed","all_expected_match"],"title":"ContextReconcileResponse"},"ConvertResponse":{"properties":{"source_format":{"type":"string","title":"Source Format"},"target":{"type":"string","title":"Target"},"target_format":{"type":"string","title":"Target Format"},"converted_verdict":{"type":"string","title":"Converted Verdict"},"remaining_issues":{"items":{"type":"string"},"type":"array","title":"Remaining Issues","description":"rule_ids still failing against the target profile."},"converted_xml_base64":{"type":"string","title":"Converted Xml Base64","description":"The re-profiled invoice (base64). In RAM only — never stored."},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"},"invoice_context_presence":{"anyOf":[{"additionalProperties":{"type":"boolean"},"type":"object"},{"type":"null"}],"title":"Invoice Context Presence"},"invoice_overview":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Invoice Overview"},"sandbox":{"type":"boolean","title":"Sandbox","default":false},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this operation (from NoxGate). For a non-sandbox call it's also the id used to write the evidence record (GET /v1/evidence/{request_id}) and, when signed, embedded in `attestation`; sandbox calls have no evidence record but still carry the id for matching against INVOX's own audit trail."}},"type":"object","required":["source_format","target","target_format","converted_verdict","remaining_issues","converted_xml_base64"],"title":"ConvertResponse"},"CreateApiKeyResponse":{"properties":{"key_id":{"type":"integer","title":"Key Id"},"api_key":{"type":"string","title":"Api Key"},"prefix":{"type":"string","title":"Prefix"}},"type":"object","required":["key_id","api_key","prefix"],"title":"CreateApiKeyResponse"},"CreateKeyRequest":{"properties":{"label":{"type":"string","title":"Label"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions","default":["validate","evidence","explain"]},"partner_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Partner Id"},"ip_allowlist":{"items":{"type":"string"},"type":"array","title":"Ip Allowlist","default":[]}},"type":"object","required":["label"],"title":"CreateKeyRequest"},"CredentialSummary":{"properties":{"id":{"type":"integer","title":"Id"},"nickname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nickname"},"created_at":{"type":"string","title":"Created At"},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"},"transports":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Transports"}},"type":"object","required":["id","nickname","created_at","last_used_at"],"title":"CredentialSummary"},"DRRResponse":{"properties":{"report":{"additionalProperties":true,"type":"object","title":"Report"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"type":"object","required":["report"],"title":"DRRResponse"},"DeleteAccountRequest":{"properties":{"password":{"type":"string","title":"Password"}},"type":"object","required":["password"],"title":"DeleteAccountRequest"},"DeliverabilityResponse":{"properties":{"deliverable":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Deliverable"},"channel":{"type":"string","title":"Channel"},"recipient":{"additionalProperties":true,"type":"object","title":"Recipient"},"checks":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Checks"},"reasons":{"items":{"type":"string"},"type":"array","title":"Reasons"},"note":{"type":"string","title":"Note"}},"type":"object","required":["deliverable","channel","recipient","checks","reasons","note"],"title":"DeliverabilityResponse"},"DeliveryLogEntry":{"properties":{"id":{"type":"string","title":"Id"},"event":{"type":"string","title":"Event"},"last_status":{"type":"string","title":"Last Status","description":"'pending' | 'delivered' | 'dead_letter'."},"attempts":{"type":"integer","title":"Attempts"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"created_at":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Updated At"},"is_test":{"type":"boolean","title":"Is Test","default":false},"replayed_from_delivery_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Replayed From Delivery Id"}},"type":"object","required":["id","event","last_status","attempts"],"title":"DeliveryLogEntry"},"DeliverySearchEntry":{"properties":{"id":{"type":"string","title":"Id"},"webhook_id":{"type":"string","title":"Webhook Id"},"event":{"type":"string","title":"Event"},"last_status":{"type":"string","title":"Last Status","description":"'pending' | 'delivered' | 'dead_letter'."},"attempts":{"type":"integer","title":"Attempts"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"created_at":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Created At"},"updated_at":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Updated At"},"is_test":{"type":"boolean","title":"Is Test","default":false},"replayed_from_delivery_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Replayed From Delivery Id"}},"type":"object","required":["id","webhook_id","event","last_status","attempts"],"title":"DeliverySearchEntry","description":"Same safe field set as webhooks.py's DeliveryLogEntry, plus webhook_id\n— needed here (and not there) because one request_id search can surface\nattempts against MULTIPLE webhooks, whereas DeliveryLogEntry is always\nlisted underneath one already-identified webhook_id."},"DemoValidateRequest":{"properties":{"xml":{"anyOf":[{"type":"string","maxLength":51200,"minLength":1},{"type":"null"}],"title":"Xml","description":"Small XML invoice body (XRechnung/UBL/CII/EN16931). Capped at 50 KB — this is a teaser, use /v1/validate with a real API key for production volume."},"pdf_base64":{"anyOf":[{"type":"string","maxLength":699058,"minLength":8},{"type":"null"}],"title":"Pdf Base64","description":"ZUGFeRD/Factur-X PDF, base64-encoded (max. 512 KB decoded). Send either `xml` or `pdf_base64`, not both."}},"type":"object","title":"DemoValidateRequest"},"DraftIssue":{"properties":{"rule_id":{"type":"string","title":"Rule Id"},"severity":{"type":"string","title":"Severity"},"human_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Message"},"field_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Field Name"},"fix_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fix Hint"}},"type":"object","required":["rule_id","severity"],"title":"DraftIssue"},"DraftResponse":{"properties":{"draft":{"type":"boolean","title":"Draft","default":true},"verdict":{"type":"string","title":"Verdict"},"format_detected":{"type":"string","title":"Format Detected"},"issues":{"items":{"$ref":"#/components/schemas/DraftIssue"},"type":"array","title":"Issues"},"language":{"type":"string","title":"Language"},"note":{"type":"string","title":"Note"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"type":"object","required":["verdict","format_detected","issues","language","note"],"title":"DraftResponse"},"EfacturaResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"index_incarcare":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Index Incarcare"},"stare":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Stare"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"outbound_check":{"type":"string","enum":["passed","blocked"],"title":"Outbound Check","description":"Outbound validation gate result.","default":"blocked"},"invoice_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Hash"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this operation — also embedded in `proof` (when present) and in INVOX's own logs/audit trail for this request."}},"type":"object","required":["accepted","detail"],"title":"EfacturaResponse"},"ExplainRequest":{"properties":{"violations":{"items":{"$ref":"#/components/schemas/Violation"},"type":"array","title":"Violations"},"autofix_candidates":{"items":{"$ref":"#/components/schemas/FixSuggestion"},"type":"array","title":"Autofix Candidates"}},"type":"object","title":"ExplainRequest"},"ExplainResponse":{"properties":{"human_violations":{"items":{"$ref":"#/components/schemas/HumanViolationOut"},"type":"array","title":"Human Violations"},"fixable_count":{"type":"integer","title":"Fixable Count"},"manual_count":{"type":"integer","title":"Manual Count"},"summary":{"type":"string","title":"Summary"},"language":{"type":"string","title":"Language","default":"de"}},"type":"object","required":["human_violations","fixable_count","manual_count","summary"],"title":"ExplainResponse"},"ExtractResponse":{"properties":{"extracted":{"additionalProperties":true,"type":"object","title":"Extracted"},"confidence":{"type":"number","title":"Confidence"},"verdict":{"type":"string","title":"Verdict"},"format_detected":{"type":"string","title":"Format Detected"},"errors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Errors"},"xml_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Xml Base64"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"},"extraction_source":{"type":"string","title":"Extraction Source","default":"deterministic"},"sub_processor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sub Processor"},"sandbox":{"type":"boolean","title":"Sandbox","default":false},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"type":"object","required":["extracted","confidence","verdict","format_detected","errors"],"title":"ExtractResponse"},"FaceResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"codigo_registro":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Codigo Registro"},"resultado_codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resultado Codigo"},"nombre":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nombre"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"outbound_check":{"type":"string","enum":["passed","blocked"],"title":"Outbound Check","description":"Outbound validation gate result.","default":"blocked"},"invoice_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Hash"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this operation — also embedded in `proof` (when present) and in INVOX's own logs/audit trail for this request."}},"type":"object","required":["accepted","detail"],"title":"FaceResponse"},"FiskalizacijaResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"registration_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Registration Id"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"outbound_check":{"type":"string","enum":["passed","blocked"],"title":"Outbound Check","description":"Outbound validation gate result.","default":"blocked"},"invoice_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Hash"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this operation — also embedded in `proof` (when present) and in INVOX's own logs/audit trail for this request."}},"type":"object","required":["accepted","detail"],"title":"FiskalizacijaResponse"},"FixSuggestion":{"properties":{"violation_rule_id":{"type":"string","title":"Violation Rule Id"},"description":{"type":"string","title":"Description"},"patch_hint":{"type":"string","title":"Patch Hint","description":"Concrete XML snippet or XPath correction hint."}},"type":"object","required":["violation_rule_id","description","patch_hint"],"title":"FixSuggestion"},"ForgetRequest":{"properties":{"invoice_number":{"type":"string","title":"Invoice Number"},"issuer_id":{"type":"string","title":"Issuer Id"}},"type":"object","required":["invoice_number","issuer_id"],"title":"ForgetRequest"},"GenerateBatchItemResult":{"properties":{"index":{"type":"integer","title":"Index","description":"Position of this item in the submitted `items` array."},"success":{"type":"boolean","title":"Success","description":"True if this item was processed without a hard failure (quota exhaustion, invalid input, engine crash). Does NOT mean the generated invoice is conformant — check `verdict`."},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"},"verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Verdict"},"format_detected":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Format Detected"},"errors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Errors"},"xml_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Xml Base64"},"pdf_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pdf Base64"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Same id used to write this item's evidence record (GET /v1/evidence/{request_id}) and, when signed, embedded in `attestation`."}},"type":"object","required":["index","success"],"title":"GenerateBatchItemResult"},"GenerateBatchRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/GenerateRequest"},"type":"array","title":"Items"}},"type":"object","title":"GenerateBatchRequest"},"GenerateBatchResponse":{"properties":{"batch_id":{"type":"string","title":"Batch Id","description":"UUID identifying this batch request."},"total":{"type":"integer","title":"Total"},"success_count":{"type":"integer","title":"Success Count","description":"Number of items processed without a hard failure."},"failed_count":{"type":"integer","title":"Failed Count","description":"Number of items that failed to process (quota exhausted, invalid input, engine crash)."},"results":{"items":{"$ref":"#/components/schemas/GenerateBatchItemResult"},"type":"array","title":"Results"},"processing_ms":{"type":"integer","title":"Processing Ms","default":0}},"type":"object","required":["batch_id","total","success_count","failed_count"],"title":"GenerateBatchResponse"},"GenerateRequest":{"properties":{"invoice":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Invoice"},"csv":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Csv"},"syntax":{"type":"string","title":"Syntax","default":"ubl"},"embed_attestation":{"type":"boolean","title":"Embed Attestation","default":false}},"type":"object","title":"GenerateRequest"},"GenerateResponse":{"properties":{"verdict":{"type":"string","title":"Verdict"},"format_detected":{"type":"string","title":"Format Detected"},"errors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Errors"},"xml_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Xml Base64"},"pdf_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pdf Base64"},"warnings":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Warnings"},"business_reference_presence":{"anyOf":[{"additionalProperties":{"type":"boolean"},"type":"object"},{"type":"null"}],"title":"Business Reference Presence","description":"Presence-only BT-10/12..16 hints from the generated XML."},"invoice_context_presence":{"anyOf":[{"additionalProperties":{"type":"boolean"},"type":"object"},{"type":"null"}],"title":"Invoice Context Presence","description":"Presence-only workflow hints for attachments, periods, payment terms and special invoice shape."},"invoice_overview":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Invoice Overview","description":"Key data read from the generated XML for display; values are not persisted."},"conformity_scope":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Conformity Scope","description":"Technical conformity scope and explicit limitations."},"outbound_check":{"type":"string","title":"Outbound Check","description":"Generation is outbound-ready only when this is 'passed'.","default":"blocked"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"type":"object","required":["verdict","format_detected","errors","attestation"],"title":"GenerateResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HumanViolationOut":{"properties":{"rule_id":{"type":"string","title":"Rule Id"},"severity":{"type":"string","title":"Severity"},"human_message":{"type":"string","title":"Human Message"},"field_name":{"type":"string","title":"Field Name"},"bt_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bt Number"},"technical_ref":{"type":"string","title":"Technical Ref"},"fix_hint":{"type":"string","title":"Fix Hint"},"auto_fix_possible":{"type":"boolean","title":"Auto Fix Possible"},"xpath":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Xpath"},"why":{"anyOf":[{"$ref":"#/components/schemas/WhyOut"},{"type":"null"}]}},"type":"object","required":["rule_id","severity","human_message","field_name","bt_number","technical_ref","fix_hint","auto_fix_possible"],"title":"HumanViolationOut"},"InboundResponse":{"properties":{"received":{"type":"boolean","title":"Received"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"sender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender"},"receiver":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Receiver"},"doc_type_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Type Id"},"doc_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Hash"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail"},"invoice_context_presence":{"anyOf":[{"additionalProperties":{"type":"boolean"},"type":"object"},{"type":"null"}],"title":"Invoice Context Presence"},"invoice_overview":{"anyOf":[{"additionalProperties":{"anyOf":[{"type":"string"},{"type":"null"}]},"type":"object"},{"type":"null"}],"title":"Invoice Overview"}},"type":"object","required":["received","detail"],"title":"InboundResponse"},"KsefResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"ksef_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ksef Number"},"reference_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reference Number"},"upo_download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upo Download Url"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"outbound_check":{"type":"string","enum":["passed","blocked"],"title":"Outbound Check","description":"Outbound validation gate result.","default":"blocked"},"invoice_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Hash"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this operation — also embedded in `proof` (when present) and in INVOX's own logs/audit trail for this request."}},"type":"object","required":["accepted","detail"],"title":"KsefResponse"},"LoginOptionsRequest":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"LoginOptionsRequest"},"LoginOptionsResponse":{"properties":{"options":{"additionalProperties":true,"type":"object","title":"Options"},"challenge_token":{"type":"string","title":"Challenge Token"}},"type":"object","required":["options","challenge_token"],"title":"LoginOptionsResponse"},"LoginRequest":{"properties":{"email":{"type":"string","title":"Email"},"password":{"type":"string","minLength":8,"title":"Password"}},"type":"object","required":["email","password"],"title":"LoginRequest"},"LoginResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"user_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"User Id"},"tenant_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Tenant Id"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"requires_2fa":{"type":"boolean","title":"Requires 2Fa","default":false},"pending_2fa_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pending 2Fa Token"}},"type":"object","required":["success"],"title":"LoginResponse"},"LoginVerifyRequest":{"properties":{"challenge_token":{"type":"string","title":"Challenge Token"},"credential":{"additionalProperties":true,"type":"object","title":"Credential"}},"type":"object","required":["challenge_token","credential"],"title":"LoginVerifyRequest"},"MailComposeRequest":{"properties":{"template":{"type":"string","title":"Template","description":"Template name. One of: supplier_correction_request, customer_invoice_issue, internal_manual_review"},"context":{"additionalProperties":true,"type":"object","title":"Context","description":"Template context values. See API docs for required keys per template."},"recipient_email":{"type":"string","title":"Recipient Email","description":"To: email address.","default":""},"sender_email":{"type":"string","title":"Sender Email","description":"From: email address (optional).","default":""}},"type":"object","required":["template"],"title":"MailComposeRequest"},"MailComposeResponse":{"properties":{"template":{"type":"string","title":"Template"},"subject":{"type":"string","title":"Subject"},"body":{"type":"string","title":"Body"},"recipient_email":{"type":"string","title":"Recipient Email"},"sender_email":{"type":"string","title":"Sender Email"},"mailto_url":{"type":"string","title":"Mailto Url","description":"RFC 2368 mailto: URL. Compatible with Outlook, Gmail, Apple Mail. Body is truncated to ~1800 chars if needed."},"eml_base64":{"type":"string","title":"Eml Base64","description":"RFC 2822 .eml file, base64-encoded."},"eml_filename":{"type":"string","title":"Eml Filename"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings"}},"type":"object","required":["template","subject","body","recipient_email","sender_email","mailto_url","eml_base64","eml_filename"],"title":"MailComposeResponse"},"MyDataResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"invoice_mark":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Mark"},"invoice_uid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Uid"},"qr_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qr Url"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"outbound_check":{"type":"string","enum":["passed","blocked"],"title":"Outbound Check","description":"Outbound validation gate result.","default":"blocked"},"invoice_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Hash"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this operation — also embedded in `proof` (when present) and in INVOX's own logs/audit trail for this request."}},"type":"object","required":["accepted","detail"],"title":"MyDataResponse"},"NavResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"transaction_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Transaction Id"},"invoice_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Status"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"outbound_check":{"type":"string","enum":["passed","blocked"],"title":"Outbound Check","description":"Outbound validation gate result.","default":"blocked"},"invoice_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Hash"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this operation — also embedded in `proof` (when present) and in INVOX's own logs/audit trail for this request."}},"type":"object","required":["accepted","detail"],"title":"NavResponse"},"PortalResponse":{"properties":{"portal_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Portal Url"}},"type":"object","required":["portal_url"],"title":"PortalResponse"},"ReferenceReconcileResponse":{"properties":{"assessed":{"type":"boolean","title":"Assessed"},"all_expected_match":{"type":"boolean","title":"All Expected Match"},"reference_presence":{"anyOf":[{"additionalProperties":{"type":"boolean"},"type":"object"},{"type":"null"}],"title":"Reference Presence"},"results":{"additionalProperties":{"additionalProperties":{"anyOf":[{"type":"boolean"},{"type":"string"}]},"type":"object"},"type":"object","title":"Results"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"content_retained":{"type":"boolean","title":"Content Retained","description":"Always false: invoice bytes and reference values are not persisted.","default":false},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id"}},"type":"object","required":["assessed","all_expected_match"],"title":"ReferenceReconcileResponse"},"RegisterOptionsResponse":{"properties":{"options":{"additionalProperties":true,"type":"object","title":"Options"},"challenge_token":{"type":"string","title":"Challenge Token"}},"type":"object","required":["options","challenge_token"],"title":"RegisterOptionsResponse"},"RegisterRequest":{"properties":{"tenant_name":{"type":"string","maxLength":100,"minLength":1,"title":"Tenant Name"},"email":{"type":"string","title":"Email"},"password":{"type":"string","minLength":8,"title":"Password"},"registration_code":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Registration Code","description":"Invite code. Only required while open registration is disabled; with open self-service registration it may be omitted."},"vat_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Vat Id","description":"EU VAT ID (USt-IdNr., e.g. DE123456789) — verified for existence via VIES. Required unless tax_number is given."},"tax_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tax Number","description":"German Steuernummer (format-only, no public registry to verify against). Required unless vat_id is given."},"referred_by":{"anyOf":[{"type":"string","maxLength":40},{"type":"null"}],"title":"Referred By"},"agb_accepted":{"type":"boolean","title":"Agb Accepted","default":false},"avv_accepted":{"type":"boolean","title":"Avv Accepted","default":false}},"type":"object","required":["tenant_name","email","password"],"title":"RegisterRequest"},"RegisterVerifyRequest":{"properties":{"challenge_token":{"type":"string","title":"Challenge Token"},"credential":{"additionalProperties":true,"type":"object","title":"Credential"},"nickname":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Nickname"}},"type":"object","required":["challenge_token","credential"],"title":"RegisterVerifyRequest"},"RegisterVerifyResponse":{"properties":{"success":{"type":"boolean","title":"Success"},"credential_id":{"type":"string","title":"Credential Id"},"nickname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nickname"}},"type":"object","required":["success","credential_id"],"title":"RegisterVerifyResponse"},"RemediateResponse":{"properties":{"original_verdict":{"type":"string","title":"Original Verdict"},"remediated_verdict":{"type":"string","title":"Remediated Verdict"},"fixed":{"type":"boolean","title":"Fixed","description":"True if autofix changed the document."},"fully_valid":{"type":"boolean","title":"Fully Valid","description":"True if the remediated document validates as 'valid'."},"applied_fixes":{"items":{"type":"string"},"type":"array","title":"Applied Fixes","description":"rule_ids whose fixable suggestions were applied."},"remaining_issues":{"items":{"type":"string"},"type":"array","title":"Remaining Issues","description":"rule_ids still failing after remediation."},"corrected_xml_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Corrected Xml Base64","description":"The corrected invoice (base64). In RAM only — never stored. Validate before use."},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation","description":"Signed, offline-verifiable attestation of the REMEDIATED version (null if signing disabled)."},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Same id used to write this operation's evidence record (GET /v1/evidence/{request_id}) and, when signed, embedded in `attestation`."}},"type":"object","required":["original_verdict","remediated_verdict","fixed","fully_valid","applied_fixes","remaining_issues"],"title":"RemediateResponse"},"RequestPasswordResetRequest":{"properties":{"email":{"type":"string","title":"Email"}},"type":"object","required":["email"],"title":"RequestPasswordResetRequest"},"ResetPasswordRequest":{"properties":{"token":{"type":"string","title":"Token"},"new_password":{"type":"string","minLength":8,"title":"New Password"}},"type":"object","required":["token","new_password"],"title":"ResetPasswordRequest"},"SamlConfigRequest":{"properties":{"idp_entity_id":{"type":"string","maxLength":500,"minLength":1,"title":"Idp Entity Id"},"idp_sso_url":{"type":"string","maxLength":1000,"minLength":1,"title":"Idp Sso Url"},"idp_x509_cert":{"type":"string","maxLength":20000,"minLength":1,"title":"Idp X509 Cert"},"require_sso":{"type":"boolean","title":"Require Sso","default":false}},"type":"object","required":["idp_entity_id","idp_sso_url","idp_x509_cert"],"title":"SamlConfigRequest"},"SamlConfigResponse":{"properties":{"tenant_id":{"type":"integer","title":"Tenant Id"},"idp_entity_id":{"type":"string","title":"Idp Entity Id"},"idp_sso_url":{"type":"string","title":"Idp Sso Url"},"require_sso":{"type":"boolean","title":"Require Sso"},"sp_entity_id":{"type":"string","title":"Sp Entity Id"},"acs_url":{"type":"string","title":"Acs Url"},"updated_at":{"type":"string","title":"Updated At"}},"type":"object","required":["tenant_id","idp_entity_id","idp_sso_url","require_sso","sp_entity_id","acs_url","updated_at"],"title":"SamlConfigResponse"},"SdiResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"identificativo_sdi":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Identificativo Sdi"},"nome_file":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nome File"},"errore":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Errore"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"outbound_check":{"type":"string","enum":["passed","blocked"],"title":"Outbound Check","description":"Outbound validation gate result.","default":"blocked"},"invoice_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Hash"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail"},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this operation — also embedded in `proof` (when present) and in INVOX's own logs/audit trail for this request."}},"type":"object","required":["accepted","detail"],"title":"SdiResponse"},"SearchResponse":{"properties":{"request_id":{"type":"string","title":"Request Id"},"request_log_found":{"type":"boolean","title":"Request Log Found","description":"Whether a matching entry exists in this tenant's own recent API request history (GET /v1/logs)."},"request_log":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Request Log","description":"The matching entry, or null if request_log_found is false."},"evidence_found":{"type":"boolean","title":"Evidence Found","description":"Whether a matching evidence/proof record exists for this tenant (GET /v1/evidence/{request_id})."},"evidence":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Evidence","description":"The evidence manifest, or null if evidence_found is false."},"webhook_deliveries_found":{"type":"boolean","title":"Webhook Deliveries Found","description":"Whether any webhook delivery attempt (any registered webhook, any status) carried this request_id."},"webhook_deliveries":{"items":{"$ref":"#/components/schemas/DeliverySearchEntry"},"type":"array","title":"Webhook Deliveries"}},"type":"object","required":["request_id","request_log_found","evidence_found","webhook_deliveries_found"],"title":"SearchResponse"},"SessionOut":{"properties":{"id":{"type":"integer","title":"Id"},"ip_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip Address"},"user_agent":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"User Agent"},"created_at":{"type":"string","title":"Created At"},"expires_at":{"type":"string","title":"Expires At"},"is_current":{"type":"boolean","title":"Is Current"}},"type":"object","required":["id","ip_address","user_agent","created_at","expires_at","is_current"],"title":"SessionOut"},"SetBrandingRequest":{"properties":{"name":{"anyOf":[{"type":"string","maxLength":80},{"type":"null"}],"title":"Name"},"logo_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Logo Url"},"accent":{"anyOf":[{"type":"string","maxLength":7},{"type":"null"}],"title":"Accent"},"favicon_url":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Favicon Url"},"tagline":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Tagline"}},"type":"object","title":"SetBrandingRequest"},"SetPdfLanguageRequest":{"properties":{"pdf_language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pdf Language"}},"type":"object","title":"SetPdfLanguageRequest"},"SetPlanRequest":{"properties":{"plan_id":{"type":"string","title":"Plan Id"},"promo_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Promo Code"}},"type":"object","required":["plan_id"],"title":"SetPlanRequest"},"SetSpendCapRequest":{"properties":{"spend_cap_eur":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Spend Cap Eur"}},"type":"object","title":"SetSpendCapRequest"},"SubKeyOut":{"properties":{"key_id":{"type":"string","title":"Key Id"},"key":{"type":"string","title":"Key"},"tenant_id":{"type":"string","title":"Tenant Id"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions"},"label":{"type":"string","title":"Label"},"created_at":{"type":"string","title":"Created At"},"revoked":{"type":"boolean","title":"Revoked"},"last_used_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used At"},"partner_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Partner Id"},"ip_allowlist":{"items":{"type":"string"},"type":"array","title":"Ip Allowlist","default":[]}},"type":"object","required":["key_id","key","tenant_id","permissions","label","created_at","revoked"],"title":"SubKeyOut"},"SubscribeRequest":{"properties":{"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"price_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Price Id"},"plan_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Id"},"interval":{"type":"string","title":"Interval","default":"month"},"promo_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Promo Code"}},"type":"object","title":"SubscribeRequest"},"SubscribeResponse":{"properties":{"checkout_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkout Url"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"customer_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Id"}},"type":"object","required":["checkout_url","session_id","customer_id"],"title":"SubscribeResponse"},"TaxLineIn":{"properties":{"base_imponible":{"type":"string","title":"Base Imponible","description":"Base imponible, e.g. '100.00'"},"cuota_repercutida":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cuota Repercutida","description":"IVA amount, e.g. '21.00'"},"tipo_impositivo":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tipo Impositivo","description":"IVA rate, e.g. '21.00'"},"impuesto":{"type":"string","title":"Impuesto","default":"01"},"clave_regimen":{"type":"string","title":"Clave Regimen","default":"01"},"calificacion_operacion":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Calificacion Operacion","default":"S1"},"operacion_exenta":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Operacion Exenta"}},"type":"object","required":["base_imponible"],"title":"TaxLineIn"},"TransmitBatchItem":{"properties":{"filename":{"type":"string","title":"Filename"},"content_base64":{"type":"string","title":"Content Base64","description":"Base64-encoded invoice bytes (XML or ZUGFeRD/Factur-X PDF)."}},"type":"object","required":["filename","content_base64"],"title":"TransmitBatchItem"},"TransmitBatchItemResult":{"properties":{"index":{"type":"integer","title":"Index","description":"Position of this item in the submitted `items` array."},"prepared":{"type":"boolean","title":"Prepared","default":false},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"blocked_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocked Reason"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"sender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender"},"receiver":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Receiver"},"doc_type_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Type Id"},"smp_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Smp Status"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"send_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Send Status"},"delivered":{"type":"boolean","title":"Delivered","default":false},"sbdh_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sbdh Base64"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail","default":""},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this item — also embedded in `proof` (when present) and in INVOX's own logs/audit trail. None only for the pre-security-gate failures (invalid base64, oversized) where NoxGate never ran and no id was ever minted."}},"type":"object","required":["index"],"title":"TransmitBatchItemResult"},"TransmitBatchRequest":{"properties":{"items":{"items":{"$ref":"#/components/schemas/TransmitBatchItem"},"type":"array","title":"Items"}},"type":"object","title":"TransmitBatchRequest"},"TransmitBatchResponse":{"properties":{"batch_id":{"type":"string","title":"Batch Id","description":"UUID identifying this batch request."},"total":{"type":"integer","title":"Total"},"prepared_count":{"type":"integer","title":"Prepared Count","description":"Number of items successfully prepared/sent."},"failed_count":{"type":"integer","title":"Failed Count","description":"Number of items that failed (security block, no embedded XML, engine crash, etc.)."},"results":{"items":{"$ref":"#/components/schemas/TransmitBatchItemResult"},"type":"array","title":"Results"},"processing_ms":{"type":"integer","title":"Processing Ms","default":0},"sandbox":{"type":"boolean","title":"Sandbox","default":false}},"type":"object","required":["batch_id","total","prepared_count","failed_count"],"title":"TransmitBatchResponse"},"TransmitResponse":{"properties":{"prepared":{"type":"boolean","title":"Prepared"},"blocked_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blocked Reason"},"invoice_verdict":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Invoice Verdict"},"outbound_check":{"type":"string","title":"Outbound Check","description":"Explicit pre-send gate: only 'passed' documents may be transmitted.","default":"blocked"},"sender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sender"},"receiver":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Receiver"},"doc_type_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Doc Type Id"},"smp_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Smp Status"},"endpoint_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Url"},"send_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Send Status"},"delivered":{"type":"boolean","title":"Delivered","default":false},"sbdh_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sbdh Base64"},"proof":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Proof"},"detail":{"type":"string","title":"Detail"},"sandbox":{"type":"boolean","title":"Sandbox","default":false},"request_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Request Id","description":"Correlation id for this operation — also embedded in `proof` (when present) and in INVOX's own logs/audit trail for this request."}},"type":"object","required":["prepared","detail"],"title":"TransmitResponse"},"TwoFactorConfirmRequest":{"properties":{"code":{"type":"string","maxLength":6,"minLength":6,"title":"Code"}},"type":"object","required":["code"],"title":"TwoFactorConfirmRequest"},"TwoFactorConfirmResponse":{"properties":{"enabled":{"type":"boolean","title":"Enabled"},"backup_codes":{"items":{"type":"string"},"type":"array","title":"Backup Codes"}},"type":"object","required":["enabled","backup_codes"],"title":"TwoFactorConfirmResponse"},"TwoFactorDisableRequest":{"properties":{"password":{"type":"string","title":"Password"}},"type":"object","required":["password"],"title":"TwoFactorDisableRequest"},"TwoFactorSetupResponse":{"properties":{"secret":{"type":"string","title":"Secret"},"otpauth_uri":{"type":"string","title":"Otpauth Uri"}},"type":"object","required":["secret","otpauth_uri"],"title":"TwoFactorSetupResponse"},"TwoFactorVerifyLoginRequest":{"properties":{"pending_2fa_token":{"type":"string","title":"Pending 2Fa Token"},"code":{"type":"string","maxLength":64,"minLength":6,"title":"Code"}},"type":"object","required":["pending_2fa_token","code"],"title":"TwoFactorVerifyLoginRequest"},"UXFeedback":{"properties":{"flow":{"type":"string","enum":["upload_validate","reference_reconcile","outbound_transmit"],"title":"Flow","default":"upload_validate"},"outcome":{"type":"string","enum":["helpful","partly_helpful","not_helpful"],"title":"Outcome","default":"not_helpful"}},"type":"object","title":"UXFeedback"},"UXMeasure":{"properties":{"flow":{"type":"string","enum":["upload_validate","reference_reconcile","outbound_transmit","demo"],"title":"Flow","default":"upload_validate"},"outcome":{"type":"string","enum":["valid","invalid","manual_review","manual_review_required","validation_failed","reference_match","reference_mismatch","blocked","sent","error"],"title":"Outcome","default":"error"},"duration_ms":{"type":"integer","maximum":3600000.0,"minimum":0.0,"title":"Duration Ms","default":0},"action_count":{"type":"integer","maximum":100.0,"minimum":0.0,"title":"Action Count","default":0},"retries":{"type":"integer","maximum":20.0,"minimum":0.0,"title":"Retries","default":0}},"type":"object","title":"UXMeasure"},"UpdateIpAllowlistRequest":{"properties":{"ip_allowlist":{"items":{"type":"string"},"type":"array","title":"Ip Allowlist","default":[]}},"type":"object","title":"UpdateIpAllowlistRequest"},"UpdateMeRequest":{"properties":{"display_name":{"type":"string","maxLength":80,"minLength":0,"title":"Display Name"}},"type":"object","required":["display_name"],"title":"UpdateMeRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ValidationResult":{"properties":{"request_id":{"type":"string","title":"Request Id"},"verdict":{"type":"string","enum":["valid","invalid","manual_review_required","validation_failed"],"title":"Verdict"},"format_detected":{"type":"string","title":"Format Detected","description":"Detected format, e.g. 'XRECHNUNG_3_UBL'."},"profile":{"type":"string","title":"Profile","description":"Specification profile, e.g. 'XRechnung-3.0.2'.","default":""},"rule_version":{"type":"string","title":"Rule Version","description":"Rule set version applied.","default":""},"ruleset":{"type":"string","title":"Ruleset","description":"Ruleset id the document was checked against, e.g. 'xrechnung-3.0'.","default":""},"ruleset_version":{"type":"string","title":"Ruleset Version","description":"Declared version of that ruleset (e.g. '3.0.2').","default":""},"validator_version":{"type":"string","title":"Validator Version","description":"Version of the validator engine used (e.g. KoSIT '1.6.2').","default":""},"checksum_sha256":{"type":"string","title":"Checksum Sha256","description":"SHA-256 hex digest of the submitted document."},"errors":{"items":{"$ref":"#/components/schemas/Violation"},"type":"array","title":"Errors"},"warnings":{"items":{"$ref":"#/components/schemas/Violation"},"type":"array","title":"Warnings"},"business_reference_presence":{"anyOf":[{"additionalProperties":{"type":"boolean"},"type":"object"},{"type":"null"}],"title":"Business Reference Presence","description":"Content-free presence hints for BT-10 buyer, BT-12 contract, BT-13 purchase order, BT-14 sales order, BT-15 receiving advice and BT-16 despatch advice (UBL/CII XML only). False means absent, not a standards failure; None means not assessed (e.g. PDF, malformed/unsupported/large XML). Values and invoice identifiers are never retained. Presence is NOT a match to an ERP record."},"invoice_context_presence":{"anyOf":[{"additionalProperties":{"type":"boolean"},"type":"object"},{"type":"null"}],"title":"Invoice Context Presence","description":"Content-free workflow hints for attachments, related documents, payment terms, allowances/charges, periods, due date, line items and credit-note shape. These flags reduce manual triage but do not assess commercial correctness, tax correctness or recipient acceptance; None means not assessed."},"invoice_overview":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Invoice Overview","description":"Key data read from the submitted XML for display next to the verdict (demo only): invoice_number (BT-1), issue_date (BT-2), type_code (BT-3), currency (BT-5), seller_name (BT-27), buyer_name (BT-44), total_net (BT-109), total_vat (BT-110), total_gross (BT-112), amount_due (BT-115). Values as written in the XML, null when absent; the XML is authoritative. Returned to the submitting caller only, never logged or persisted. None means not shown (e.g. PDF, malformed/unsupported XML)."},"autofix_candidates":{"items":{"$ref":"#/components/schemas/FixSuggestion"},"type":"array","title":"Autofix Candidates"},"raw_engine_refs":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Raw Engine Refs","description":"Anonymized engine execution metadata (no file paths, no user data)."},"evidence_hash":{"type":"string","title":"Evidence Hash","description":"SHA-256 of the audit chain entry. Set by the route handler after evidence is written.","default":""},"outbound_check":{"type":"string","enum":["not_requested","passed","blocked"],"title":"Outbound Check","description":"Explicit outbound pre-send gate. 'passed' means the supplied document returned verdict='valid'; 'blocked' means an outbound validation was requested but the document was not valid. Inbound/demo checks remain 'not_requested'.","default":"not_requested"},"outbound_block_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outbound Block Reason","description":"Machine-readable reason when outbound_check='blocked'."},"sandbox":{"type":"boolean","title":"Sandbox","description":"True if validated with a sandbox API key: real engines, real verdict, but no evidence/attestation was written and no quota/billing was touched.","default":false},"engine_consensus":{"additionalProperties":true,"type":"object","title":"Engine Consensus","description":"Which certified engines validated this document and whether they agree. INVOX exceeds the standard (one conformant engine) by running the KoSIT reference engine plus, when enabled, an independent second engine (phive). status: 'consensus' (both agree) | 'gap_flagged' (second engine flags an EN16931 issue KoSIT passed) | 'single_engine'.","readOnly":true},"classification":{"type":"string","enum":["VALID","INVALID","INDETERMINATE"],"title":"Classification","description":"Three-valued conformity status derived from verdict: 'VALID' (verdict valid), 'INVALID' (verdict invalid: at least one error-level rule violation) or 'INDETERMINATE' (manual_review_required or validation_failed: no reliable conformity statement was possible).","readOnly":true},"conformity_scope":{"additionalProperties":true,"type":"object","title":"Conformity Scope","description":"Clear scope statement for the result. This separates technical EN16931/profile conformance from commercial correctness, tax advice, and recipient acceptance.","readOnly":true},"tax_relevant_error_count":{"type":"integer","title":"Tax Relevant Error Count","description":"Number of error-level findings with tax_relevance='relevant'.","readOnly":true},"recommended_next_step":{"additionalProperties":true,"type":"object","title":"Recommended Next Step","description":"The single best next action for a human or client application. This is advisory workflow guidance, not a conformity decision.","readOnly":true},"rule_basis":{"additionalProperties":true,"type":"object","title":"Rule Basis","description":"Rule basis the verdict rests on: ruleset id/version, validator engine and version, and - when the KoSIT validator ran - the KoSIT configuration (scenarios.xml name and date) and the scenario that matched. Fields are null when the corresponding engine did not run.","readOnly":true}},"type":"object","required":["request_id","verdict","format_detected","checksum_sha256","engine_consensus","classification","conformity_scope","tax_relevant_error_count","recommended_next_step","rule_basis"],"title":"ValidationResult","description":"Complete result of a single validation request.\n\nNever contains the original document bytes.\nVerdict semantics:\n  valid                  — all rules pass, no error-level violations\n  invalid                — one or more error-level violations found\n  manual_review_required — ambiguous profile or partial rule coverage\n  validation_failed      — engine crash, JAR missing, timeout, parse error"},"VerifactuChainVerifyResponse":{"properties":{"nif":{"type":"string","title":"Nif"},"intact":{"type":"boolean","title":"Intact"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["nif","intact","detail"],"title":"VerifactuChainVerifyResponse"},"VerifactuRegisterRequest":{"properties":{"nif_emisor":{"type":"string","title":"Nif Emisor"},"nombre_razon_emisor":{"type":"string","title":"Nombre Razon Emisor"},"num_serie_factura":{"type":"string","title":"Num Serie Factura"},"fecha_expedicion_factura":{"type":"string","title":"Fecha Expedicion Factura","description":"DD-MM-YYYY"},"tipo_factura":{"type":"string","title":"Tipo Factura","default":"F1"},"descripcion_operacion":{"type":"string","title":"Descripcion Operacion"},"lineas":{"items":{"$ref":"#/components/schemas/TaxLineIn"},"type":"array","title":"Lineas"},"nif_destinatario":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nif Destinatario"},"nombre_destinatario":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Nombre Destinatario"},"submit":{"type":"boolean","title":"Submit","description":"Attempt real-time AEAT submission (VERI*FACTU mode)","default":false},"env":{"type":"string","title":"Env","description":"'test' or 'production' — governs the QR host only","default":"test"}},"type":"object","required":["nif_emisor","nombre_razon_emisor","num_serie_factura","fecha_expedicion_factura","descripcion_operacion","lineas"],"title":"VerifactuRegisterRequest"},"VerifactuRegisterResponse":{"properties":{"huella":{"type":"string","title":"Huella"},"primer_registro":{"type":"boolean","title":"Primer Registro"},"registro_alta_xml":{"type":"string","title":"Registro Alta Xml"},"qr_url":{"type":"string","title":"Qr Url"},"qr_caption_above":{"type":"string","title":"Qr Caption Above"},"qr_caption_below":{"type":"string","title":"Qr Caption Below"},"attestation":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Attestation"},"submitted":{"type":"boolean","title":"Submitted","default":false},"outbound_check":{"type":"string","enum":["passed","blocked"],"title":"Outbound Check","description":"Outbound validation gate result.","default":"blocked"},"submission_detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Submission Detail"},"aeat_csv":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Aeat Csv"},"detail":{"type":"string","title":"Detail"}},"type":"object","required":["huella","primer_registro","registro_alta_xml","qr_url","qr_caption_above","qr_caption_below","detail"],"title":"VerifactuRegisterResponse"},"Violation":{"properties":{"rule_id":{"type":"string","title":"Rule Id","description":"Rule identifier, e.g. 'BR-DE-1', 'BR-CO-3'."},"severity":{"type":"string","enum":["error","warning","info"],"title":"Severity"},"message":{"type":"string","title":"Message"},"xpath":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Xpath","description":"XPath locating the offending element."},"human_message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Human Message","description":"Human-readable German message."},"bt_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Bt Number","description":"EN16931 business term, e.g. 'BT-81'."},"auto_fix_possible":{"type":"boolean","title":"Auto Fix Possible","description":"Whether an automatic fix can be proposed.","default":false},"field_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Field Name","description":"Plain-language name of the affected invoice field (e.g. 'Käuferreferenz / Leitweg-ID'); null when the rule is not in the verified explanation catalog."},"fix_hint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fix Hint","description":"Plain-language correction path for the sender; never contains invented business values. Null when no verified hint exists for this rule."},"layer":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Layer","description":"Rule layer: 'core' (EN16931 / pan-standard PEPPOL) or 'national' (country-specific extension). The core is the shared floor that PEPPOL and all national CIUS build on; national rules may narrow but not contradict it."},"tax_relevance":{"type":"string","enum":["relevant","not_relevant","undetermined"],"title":"Tax Relevance","description":"Tax relevance of this finding, derived from rule_id (an input value is ignored): 'relevant' (the rule checks a mandatory VAT invoice particular under § 14 Abs. 4 / § 14a UStG resp. Art. 226 Directive 2006/112/EC, or the VAT category/calculation of EN 16931-1 BG-23), 'not_relevant' (transmission, routing, payment or syntax only) or 'undetermined' (not classified yet; open, not an all-clear). Technical classification of the rule, not tax advice.","default":"undetermined"},"tax_relevance_basis":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tax Relevance Basis","description":"Legal/standards basis for tax_relevance (e.g. '§ 14 Abs. 4 Satz 1 Nr. 8 UStG; Art. 226 Nr. 9, 10 MwStSystRL'); null when undetermined."},"legacy_rule_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Legacy Rule Id","description":"Former INVOX rule ID of a renamed INVOX check, for backward compatibility (e.g. 'BR-DE-3' for 'INVOX-DE-LEITWEG-1': that ID collided with the official XRechnung rule BR-DE-3 'Seller city'). Derived from rule_id (an input value is ignored); null when the rule was never renamed."}},"type":"object","required":["rule_id","severity","message"],"title":"Violation"},"WebhookCreateRequest":{"properties":{"url":{"type":"string","title":"Url","description":"HTTPS URL to POST events to."},"events":{"items":{"type":"string"},"type":"array","title":"Events","description":"Event types to subscribe to. Valid: ['batch.complete', 'quota.low', 'validation.complete', 'validation.failed']"},"secret":{"type":"string","title":"Secret","description":"HMAC signing secret for X-Invox-Signature header."}},"type":"object","required":["url","events","secret"],"title":"WebhookCreateRequest"},"WebhookReplayResponse":{"properties":{"delivery_id":{"type":"string","title":"Delivery Id","description":"New delivery-log id created for this replay attempt."},"delivered":{"type":"boolean","title":"Delivered","description":"Whether the replay was accepted (HTTP 2xx) by the endpoint."},"event":{"type":"string","title":"Event","description":"The original event type being replayed."},"replayed_from_delivery_id":{"type":"string","title":"Replayed From Delivery Id","description":"The original delivery-log id this replay was sourced from."}},"type":"object","required":["delivery_id","delivered","event","replayed_from_delivery_id"],"title":"WebhookReplayResponse"},"WebhookResponse":{"properties":{"id":{"type":"string","title":"Id"},"tenant_id":{"type":"string","title":"Tenant Id"},"url":{"type":"string","title":"Url"},"events":{"items":{"type":"string"},"type":"array","title":"Events"},"secret":{"type":"string","title":"Secret"},"created_at":{"type":"string","title":"Created At"},"active":{"type":"boolean","title":"Active"}},"type":"object","required":["id","tenant_id","url","events","secret","created_at","active"],"title":"WebhookResponse"},"WebhookTestResponse":{"properties":{"delivery_id":{"type":"string","title":"Delivery Id","description":"Delivery-log id for this attempt (usable in recent-history lookups)."},"delivered":{"type":"boolean","title":"Delivered","description":"Whether the synthetic test event was accepted (HTTP 2xx) by the endpoint."},"event":{"type":"string","title":"Event","description":"Always 'webhook.test' — never mistakable for a real business event."}},"type":"object","required":["delivery_id","delivered","event"],"title":"WebhookTestResponse"},"WhyOut":{"properties":{"standard":{"type":"string","title":"Standard"},"reference":{"type":"string","title":"Reference"},"rationale":{"type":"string","title":"Rationale"},"source_url":{"type":"string","title":"Source Url"},"layer":{"type":"string","title":"Layer"}},"type":"object","required":["standard","reference","rationale","source_url","layer"],"title":"WhyOut","description":"Regulatory/standards basis + plain-language reason for a rule."},"invox__api__routes__auth_portal__MeResponse":{"properties":{"user_id":{"type":"integer","title":"User Id"},"email":{"type":"string","title":"Email"},"role":{"type":"string","title":"Role"},"permissions":{"items":{"type":"string"},"type":"array","title":"Permissions"},"tenant_id":{"type":"integer","title":"Tenant Id"},"tenant_name":{"type":"string","title":"Tenant Name"},"totp_enabled":{"type":"boolean","title":"Totp Enabled","default":false},"pdf_language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pdf Language"}},"type":"object","required":["user_id","email","role","tenant_id","tenant_name"],"title":"MeResponse"},"invox__api__routes__me__MeResponse":{"properties":{"tenant_id":{"type":"string","title":"Tenant Id"},"display_name":{"type":"string","title":"Display Name"},"plan_id":{"type":"string","title":"Plan Id"}},"type":"object","required":["tenant_id","display_name","plan_id"],"title":"MeResponse"}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API-Schlüssel im Format in_<32 hex>_fl."}}},"servers":[{"url":"https://invoxapi.de","description":"INVOX Produktion"}]}