# PeppolCheck.fr

> Free, public directory and verification service for Peppol participants across France, Belgium, and the wider EU. PeppolCheck.fr resolves a Peppol identifier (e.g. `0208:0848934496`) to the company name, country, registered SMP access point, and the document types that participant can receive on the Peppol network.

## What this is

- A read-only HTTP + JSON API and human-facing web UI on top of the official OpenPeppol SML, SMP, and Peppol Directory.
- Coverage: ~2.5 million participants across 34 Peppol-connected countries.
- Refresh: directory data synced nightly from the official OpenPeppol registries.
- Cost: free, no registration, no API key.

## Capabilities

- Resolve a Peppol participant by ID (`{scheme}:{value}`, e.g. `0208:0848934496`).
- Search Peppol participants by company name, VAT number, or registry ID (SIREN, KvK, OrgNr…).
- Return SMP access point URL, hostname, service count, and the resolved document type endpoint metadata.
- Return Peppol Directory record: registered name, country, additional info, geo info, document types.

## Use this when

- You need to verify that a company is reachable on Peppol before sending an e-invoice.
- You need to discover which document types (e.g. UBL Invoice, CreditNote, Order) a participant accepts.
- You need to look up a French (FR), Belgian (BE), or EU access point for a known VAT or SIREN.
- You want a programmatic way to enrich an AP or ERP integration with Peppol routing data.

## Do NOT use this for

- Sending or receiving Peppol documents. PeppolCheck.fr is read-only directory data; it is not a Peppol Access Point.
- Legally binding registry data. Always confirm critical lookups against the official OpenPeppol SML/SMP.
- Bulk scraping. Use the search and participant endpoints respectfully; reasonable per-IP rate limits apply.

## API

- OpenAPI 3.1 spec: https://peppolcheck.fr/openapi.json
- API reference (human-readable): https://peppolcheck.fr/api-reference
- Developer docs: https://peppolcheck.fr/docs
- Get participant: `GET https://peppolcheck.fr/api/v1/participant/{scheme}:{value}` → JSON
- Search by name/VAT: `GET https://peppolcheck.fr/api/v1/search?q={query}` → JSON
- Errors: structured JSON `{ "error": { "code": "...", "message": "..." } }`

## Authentication

The public API requires no authentication. See https://peppolcheck.fr/auth.md for the agent-auth metadata if you are building an agent integration.

## Agent integration

- MCP server (Streamable HTTP): https://peppolcheck.fr/mcp
- MCP server card: https://peppolcheck.fr/.well-known/mcp/server-card.json
- A2A agent card: https://peppolcheck.fr/.well-known/agent-card.json
- Agent discovery: https://peppolcheck.fr/.well-known/agent.json
- NLWeb /ask endpoint: `POST https://peppolcheck.fr/ask` (JSON + optional SSE)
- API catalog (RFC 9727): https://peppolcheck.fr/.well-known/api-catalog
- OAuth protected-resource metadata (RFC 9728): https://peppolcheck.fr/.well-known/oauth-protected-resource

## Identity

- Brand: PeppolCheck.fr
- Operator: e-invoice.be
- Contact: willem@e-invoice.be
- Jurisdiction: France (legal terms in French at https://peppolcheck.fr/mentions-legales)
- License of data: directory data sourced from OpenPeppol registries under their public terms.

## Further reading

- Human homepage: https://peppolcheck.fr/
- About: https://peppolcheck.fr/about
- Contact: https://peppolcheck.fr/contact
- Privacy: https://peppolcheck.fr/privacy
- Comparison vs. alternatives: https://peppolcheck.fr/compare
- Comparison subpages:
  - https://peppolcheck.fr/compare/peppolcheck-be
  - https://peppolcheck.fr/compare/openpeppol-directory
  - https://peppolcheck.fr/compare/storecove
- Guides:
  - https://peppolcheck.fr/guides/verify-peppol-id
  - https://peppolcheck.fr/guides/find-peppol-id-by-vat
  - https://peppolcheck.fr/guides/peppol-france-2026
  - https://peppolcheck.fr/guides/peppol-id-format
- Full markdown manual: https://peppolcheck.fr/llms-full.txt
- Per-section indices: https://peppolcheck.fr/docs/llms.txt, https://peppolcheck.fr/api/llms.txt

## Source code and agent configs

- GitHub: https://github.com/e-invoice-be/peppolcheck-fr
- Agent coding rules: https://github.com/e-invoice-be/peppolcheck-fr/blob/main/AGENTS.md (also at https://peppolcheck.fr/AGENTS.md)
- Cursor rules: https://github.com/e-invoice-be/peppolcheck-fr/blob/main/.cursorrules
- skills.sh skill: https://github.com/e-invoice-be/peppolcheck-fr/blob/main/SKILL.md (also at https://peppolcheck.fr/SKILL.md)