W System

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…

Finance & banking#business

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-terms returns the W System Peppol mandate terms (https://wsystem.dev/legal/peppol-mandate-terms, DPA: https://wsystem.dev/legal/dpa); POST /einvoice/mandates records the company's click-through mandate with a signed receipt. Platforms (one key, many client companies): GET /platform/companies lists 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 header X-Company: on POST /einvoice/validate, /create, /preflight or /send (sandbox too) to see those calls per company in calls_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

How to test the W System in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the W System collection, without the publisher's secrets.
  3. 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.
  4. 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.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.