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…
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 50
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
KSeF (Poland)
- GETPoland KSeF connector: what works, environment, how to connect (free)
/einvoice/ksef - GETList the KSeF connections (companies) under your API key
/einvoice/ksef/connections - POSTConnect a company's KSeF account (TEST, or DEMO if enabled): store its KSeF token encrypted after a sign-in check
/einvoice/ksef/connections - POSTCreate a fictitious company in KSeF TEST (random NIP) and connect it, to try KSeF sending end to end
/einvoice/ksef/test-company - POSTStart certificate sign-in: get a KSeF challenge and the unsigned AuthTokenRequest XML to sign externally
/einvoice/ksef/auth/challenge - POSTFinish certificate sign-in: accept the signed AuthTokenRequest, enroll a KSeF Authentication certificate, store it encrypted
/einvoice/ksef/auth/complete - DELETERevoke a KSeF connection: the stored KSeF token is deleted at once
/einvoice/ksef/connections/:cid - GETKSeF status of a sent invoice: processing / accepted (KSeF number) / rejected (code and reason) (free)
/einvoice/ksef/invoices/:sid - GETUPO (official KSeF receipt, XML signed by the Ministry of Finance) of an accepted invoice (free)
/einvoice/ksef/invoices/:sid/upo - GETList invoices sent to KSeF under your API key (newest first, free)
/einvoice/ksef/invoices
- GETLiveness check
/health
API details
- Base URL
https://api.wsystem.dev- Authentication
- An API key in the X-API-Key header
- Operations
- 50 operations on 47 pathsGET 27POST 20DELETE 2PUT 1
- Main resources
- E-invoice 17KSeF (Poland) 10Platform 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 Finance & banking and has 50 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?
50 operations on 47 paths (27 GET, 20 POST, 2 DELETE, 1 PUT). The largest groups are E-invoice, KSeF (Poland), Platform, Billing.
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.