InvoiceIn
Any received European or UAE (PINT AE) e-invoice in — canonical JSON, validation report with fix hints, PDF, CSV and DATEV out. Accepted inputs: XRechnung…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Any received European or UAE (PINT AE) e-invoice in — canonical JSON, validation report with fix hints, PDF, CSV and DATEV out.
Accepted inputs: XRechnung (UBL or CII), EN 16931 UBL 2.1 Invoice/CreditNote, Peppol BIS Billing 3, CII D16B,
ZUGFeRD 1.0 / 2.x and Factur-X hybrid PDFs (the XML is extracted from the PDF), Italy's FatturaPA 1.2,
Poland's KSeF FA(2)/FA(3), Romania's RO e-Factura (CIUS-RO), the UAE's PINT AE (Billing and Self-Billing).
Send the file as multipart field file or as the raw request body. Nothing is persisted; processing is in memory only.
Poland: the KSeF number is not part of the FA(2)/FA(3) document — pass it as ?ksef= or X-KSeF-Number and it is
checked against the invoice and returned on payment.ksef_number, the reference art. 108g requires in the transfer
title from 1 January 2027.
Versions: every validation names the rule sets it ran, with versions — validation.rule_sets and validation.coverage in the body, X-Invoicein-Rulesets and X-Invoicein-Coverage on the response. coverage: schema means only XSD and arithmetic could run (a profile below EN 16931, FatturaPA, KSeF): valid: true is then "nothing we could check failed", not a conformance verdict. Dated changes: GET /v1/rulesets and https://invoicein.peculiar.systems/rules/changelog (Atom feed).
Auth: Authorization: Bearer or X-Api-Key: . Without a key, a small per-IP daily quota applies (5 invoices a day), and every such answer says how many are left in credits.note.
A free key — 100 invoices, no card, no expiry — is issued at once: POST /v1/keys with {"email": "you@company.com"}, or the form on https://invoicein.peculiar.systems/#get.
One invoice = one credit, whatever outputs you ask for; a file that carries several invoices (a FatturaPA lot) costs one credit per invoice.
Endpoints 15
invoice
- POSTEverything in one call: canonical JSON + validation (+ optional html/pdf/csv/datev)
/v1/invoice - POSTCanonical JSON only (no validation)
/v1/parse - POSTValidation report with fix hints (no invoice body)
/v1/validate
render
- POSTHuman-readable HTML
/v1/render.html - POSTHuman-readable PDF (A4)
/v1/render.pdf
export
- POSTFlat CSV (one row per line item, or per document with level=documents)
/v1/export.csv - POSTDATEV Buchungsstapel (EXTF 700, UTF-8) for the incoming invoice
/v1/export.datev
meta
- GETSupported input formats and rule-set versions
/v1/formats - GETRule-set versions in force and their dated changelog
/v1/rulesetsEvery rule set and schema the validator runs, at the version it runs today, plus the public changelog (newest first). The same table prints on every /rules… - GETWhich format each country's mandate asks for, and what we validate it with
/v1/countries - GETPlain-language explanation of a validation rule id
/v1/rules/:rule_id - GETCheck an EU VAT number: format offline, then live VIES, with the dated receipt
/v1/vat/:numberFree and unmetered: this calls the Commission's own service, so it costs us nothing and costs you no credits. A failed lookup never comes back as invalid — an… - GETIs a counterparty published on Peppol, and what can it receive
/v1/peppol/:identifierRegistry presence from the Peppol Directory — 0088:1234567890128, or free text to search. Free and unmetered. A directory outage comes back as unverified,… - GETCanonical JSON field guide (BT/BG numbers)
/v1/schema
keys
- POSTA free API key, issued at once: 100 invoices, no card, no expiry
/v1/keysOne free key per e-mail address. The key is in the answer — shown once — and is mailed to the address. When the 100 invoices are used, a credit pack is added…
API details
- Base URL
https://invoicein-api.peculiar.systems- Authentication
- An API key in the X-Api-Key header
A bearer token in the Authorization header - Operations
- 15 operations on 15 pathsPOST 8GET 7
- Main resources
- meta 7invoice 3export 2render 2keys 1
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
0.1.0 - Links
- OpenAPI document
How to test the InvoiceIn in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the InvoiceIn collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-Api-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Everything in one call: canonical JSON + validation (+ optional html/pdf/csv/datev)” (POST /v1/invoice), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the InvoiceIn?
Any received European or UAE (PINT AE) e-invoice in — canonical JSON, validation report with fix hints, PDF, CSV and DATEV out. Accepted inputs: XRechnung… It is listed under Finance & banking and has 15 endpoints.
Who publishes the InvoiceIn?
It is listed from Peculiar's public API description (an OpenAPI document), not published by Peculiar on Swastik Codes. Anyone who controls invoicein.peculiar.systems can claim the profile by adding a DNS TXT record.
What is the base URL of the InvoiceIn?
Requests go to https://invoicein-api.peculiar.systems. Endpoint paths are added to this base URL.
How do I authenticate with the InvoiceIn?
It accepts 2 methods: an API key in the X-Api-Key header; A bearer token in the Authorization header.
How many endpoints does the InvoiceIn have?
15 operations on 15 paths (8 POST, 7 GET). The largest groups are meta, invoice, export, render.
Is forking the InvoiceIn free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.