W System
EU e-invoicing and business-data API: VAT/VIES and EORI validation, KYB, sanctions screening, EN 16931 e-invoice validation, Peppol lookup. Pay per call via…
Developer tools#data-validation
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
EU e-invoicing and business-data API: VAT/VIES and EORI validation, KYB, sanctions screening, EN 16931 e-invoice validation, Peppol lookup. Pay per call via x402 or use an API key; MCP server available.
Endpoints: EU VAT number validation (VIES), EORI validation (EC EOS), official company-registry lookup, sanctions screening (EU, UN, OFAC SDN, UK), one-call KYB, a due-diligence report, and EU e-invoicing: validate (EN 16931, XRechnung; UBL, CII, ZUGFeRD/Factur-X PDF), create (JSON -> UBL), 'can I e-invoice this company?' (VIES + Peppol + mandates), and SANDBOX send (verify -> create -> route -> transport -> signed evidence; transport = mock, or a real submission through partner Peppol access-point sandboxes: Recommand playground or e-invoice.be sandbox). Live Peppol sending (mode=live) runs over production Peppol through our certified access-point partner (e-invoice.be) and is switched on per company after a Peppol mandate (click-through) and W System's KYC review; then GET /einvoice/live/{document_id} shows the delivery state, GET /einvoice/inbox lists documents received on Peppol and GET /einvoice/inbox/{document_id}/ubl downloads one. Peppol plans: https://wsystem.dev/pricing/peppol.
- No API key, no signup: every client IP gets 20 free calls/day across all endpoints (header
X-Free-Remaining). - Beyond the free tier: pay per call with x402 (USDC on Base, HTTP 402 flow): $0.01 per single check, $0.10 per batch request, $0.045 per KYB check; e-invoice validate $0.03, parse $0.01, create $0.08, route $0.02; due-diligence report $0.49. Or use an API key.
- Live Peppol onboarding (API key):
GET /einvoice/mandate-termsreturns the W System Peppol mandate terms (https://wsystem.dev/legal/peppol-mandate-terms, DPA: https://wsystem.dev/legal/dpa);POST /einvoice/mandatesrecords the company's click-through mandate with a signed receipt. Platforms (one key, many client companies):GET /platform/companieslists every company under your key with its onboarding stage (mandate, KYC, sending account, Peppol registration), whether it is live, the next step and per-company live document counts for your own billing. Send the headerX-Company:on POST /einvoice/validate, /create, /preflight or /send (sandbox too) to see those calls per company incalls_this_month(the company must be yours; tagging never changes billing). - MCP: the same tools are available to AI agents at
https://api.wsystem.dev/mcp/(streamable HTTP). - VIES/EOS are official European Commission services; this API adds retries when a member state is unavailable, caching,
batch endpoints, audit consultation numbers and a stable JSON shape. Docs: https://wsystem.dev/llms.txt
Endpoints 40
VAT
- GETVIES availability per member state (free, cached 5 min)
/vies/statusProxy of the European Commission VIES check-status endpoint, cached for 5 minutes. Free; does not use the free-tier quota. national_fallback = this API can… - GETValidate one EU VAT number (VIES)
/verify?vat=HU33119856Check whether an EU VAT number (with country prefix, e.g. IE6388047V, DE811193231, HU33119856) is valid in the official VIES system (EU-27 + XI Northern… - POSTValidate up to 100 EU VAT numbers
/verify/batchBatch VIES validation. Body: {"vats": [...], "requester": "optional own VAT"}. Same per-item result shape as GET /verify (GB items: member_state_unavailable…
EORI
- GETValidate one EU EORI number (EC EOS)
/eori?eori=SE5560360793Check an EU EORI (Economic Operators Registration and Identification) number such as SE5560360793 against the official European Commission EOS service.… - POSTValidate up to 100 EU EORI numbers
/eori/batchBody: {"eoris":[...]}. x402 $0.10.
Company
- GETLook up a company in official EU business registers
/company?q=552032534Search by company name or registry number. country: FR (SIREN/SIRET), NO (org.nr), FI (Y-tunnus), CZ (IČO), PL (KRS number, or name: matched via the GLEIF LEI… - POSTBatch company-registry lookup (max 25 queries)
/company/batchBody: {"queries":[{"query":"552032534","country":"FR"}], "limit":3}. x402 $0.10 per batch request (1 unit with an API key). Single lookups via GET /company…
Sanctions
- GETScreen a name against EU, UN, OFAC and UK sanctions lists
/sanctions/screen?name=SberbankFuzzy, transliteration-aware matching of a person or company name against the official EU consolidated list, UN Security Council list, US OFAC SDN and UK… - POSTBatch sanctions screening (max 50 names)
/sanctions/screen/batchBody: {"names":[...], "threshold":85}. x402 $0.10.
KYB
- POSTOne-call KYB: VAT + registry + sanctions -> verdict
/kyb/checkKnow-your-business check of an EU company in one request: VIES VAT validation, official business-register lookup (national registers for FR, NO, FI, CZ, PL,… - POSTCounterparty due-diligence report (VAT, register, sanctions, EORI, LEI, Peppol) with risk flags
/ddreportOne call bundles VIES VAT validation, official business-register lookup, EU/UN/OFAC/UK sanctions screening, EC EORI check, GLEIF LEI record and the Peppol /…
E-invoice
- GETGet the Peppol mandate terms to show the signer
/einvoice/mandate-terms - POSTRecord a company's Peppol mandate (click-through acceptance)
/einvoice/mandates - GETGet one of your Peppol mandate records
/einvoice/mandates/:mid - POSTRevoke a Peppol mandate
/einvoice/mandates/:mid/revoke - GETLIVE: documents received over Peppol for your mandated companies (X-API-Key)
/einvoice/inboxLists invoices and credit notes that suppliers sent to your companies' Peppol IDs (newest first). Needs a live Peppol sending account. Each item has the… - GETLIVE: signed download link for a received document's original UBL (valid 1 hour)
/einvoice/inbox/:document_id/ubl - GETLIVE: delivery state of a document you sent with mode=live (TRANSIT -> SENT, or FAILED = not charged)
/einvoice/live/:document_id - POSTValidate an EU e-invoice (EN 16931, XRechnung; UBL, CII, ZUGFeRD/Factur-X PDF)
/einvoice/validateSend the invoice as the raw request body (Content-Type application/xml or application/pdf), or JSON {"xml": "..."} / {"base64": "<XML or PDF>"}. Detects UBL… - POSTRead an incoming EU e-invoice (UBL, CII, ZUGFeRD/Factur-X PDF) into JSON
/einvoice/parseSame input as /einvoice/validate: the raw invoice as the request body (application/xml or application/pdf), or JSON {"xml": "..."} / {"base64": "<XML or… - POSTCreate a valid EU e-invoice (UBL 2.1) from simple JSON
/einvoice/createTurns JSON (seller, buyer, lines with VAT category/rate, payment) into a UBL 2.1 invoice or credit note in format en16931 (plain EN 16931), xrechnung (German… - GET"Can I e-invoice this company?" VAT + Peppol + country mandate lookup
/einvoice/route?id=BE0403170701id: an EU VAT number (e.g. BE0403170701) or a Peppol participant id (e.g. 0208:0403170701). Returns the VIES VAT result, whether the company is on Peppol… - GETIs this platform on France's official list of Plateformes Agréées (PA)? (free)
/fr/pa-registryname: platform or company name (e.g. Pennylane); website: its site (e.g. https://www.acubeapi.com/). Checks the DGFiP lists published on impots.gouv.fr:… - GETExample JSON body for POST /einvoice/create (free)
/einvoice/sample - POSTSANDBOX: verify buyer -> create -> validate -> route -> transmit (mock or partner Peppol sandbox) -> signed evidence receipt
/einvoice/sendOne call for the whole e-invoice flow. Body: {"invoice": <same JSON as POST /einvoice/create>, "mode": "sandbox", "transport": "mock"}. Safe send: every send… - POSTSafe send: check the buyer and the invoice before sending (VAT, Peppol, sanctions, EN 16931) -> ok / warn / block
/einvoice/preflightRuns the checks POST /einvoice/send does before it sends, without sending anything, and returns one verdict: ok, warn or block, with a result (pass | warn |… - GETPublic key (JWK) for verifying /einvoice/send evidence receipts (free)
/einvoice/evidence-key - GETAggregate e-invoice usage counts for the current UTC month (free; no PII)
/einvoice/usageDay-90 gate helper. live_transmitted counts successful POST /einvoice/send with mode=live and transmission.transmitted=true. Sandbox sends are listed…
Billing
- GETMonthly API-key plans
/billing/plans - GETYour API key's plan, monthly quota, units used, and paid x402 calls attributed to this key (free; no units consumed)
/billing/usage - POSTStart Stripe Checkout for a monthly plan
/billing/checkout
Platform
- GETList the client companies under your key: onboarding stage, live readiness and per-company live document counts
/platform/companies - GETOne client company under your key: onboarding stage, next step and live document counts
/platform/companies/:mandate_id - GETYour webhook URL and its recent deliveries (the secret is never shown again)
/platform/webhook - POSTSet or replace your webhook URL for company.stage_changed (signing secret returned once)
/platform/webhook - DELETERemove your webhook
/platform/webhook - POSTSend a signed webhook.test event to your URL now and return the delivery result
/platform/webhook/test - GETPlatform plan: this month's checked documents, Peppol documents, active companies and cost estimate (free)
/platform/usage - PUTPlatform plan: set or remove an optional monthly spend cap in EUR (calls that would exceed it get 429, nothing charged)
/platform/spend-cap
- GETLiveness check
/health
API details
- Base URL
https://api.wsystem.dev- Authentication
- An API key in the X-API-Key header
- Operations
- 40 operations on 38 pathsGET 22POST 16PUT 1DELETE 1
- Main resources
- E-invoice 17Platform 8Billing 3VAT 3Company 2EORI 2KYB 2Sanctions 2
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
0.3.110 - Links
- Documentation · OpenAPI document · Support
- Listed from
- Wsystem's published OpenAPI description
How to test the W System 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 W System 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 “VIES availability per member state (free, cached 5 min)” (GET /vies/status), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the W System?
EU e-invoicing and business-data API: VAT/VIES and EORI validation, KYB, sanctions screening, EN 16931 e-invoice validation, Peppol lookup. Pay per call via… It is listed under Developer tools and has 40 endpoints.
Who publishes the W System?
It is listed from W System's public API description (an OpenAPI document), not published by W System on Swastik Codes. Anyone who controls wsystem.dev can claim the profile by adding a DNS TXT record.
What is the base URL of the W System?
Requests go to https://api.wsystem.dev. Endpoint paths are added to this base URL.
How do I authenticate with the W System?
With an API key in the X-API-Key header.
How many endpoints does the W System have?
40 operations on 38 paths (22 GET, 16 POST, 1 PUT, 1 DELETE). The largest groups are E-invoice, Platform, Billing, VAT.
Is forking the W System free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.