Documentation

Quickstart

1. Read /llms.txt for site context.
2. Pick a discovery surface: api-catalog, mcp/server-card.json, agent-card.json, or agent-skills/index.json.
3. Hit /api/v1 for the service index.
4. Fetch resources (articles, feeds, countries, specs, sources).
5. Ask in natural language at POST /ask.

Authentication

Reads are anonymous. Optional signed requests via RFC 9421 (keys in /.well-known/http-message-signatures-directory). Future write surfaces follow OAuth (see /auth.md).

Conventions

• Dates are ISO 8601 UTC.
• Slugs are lowercase kebab-case.
• Article URLs follow /YYYY/MM/{slug}/.
• Locales: en (canonical), nl, fr, de, it, es, pl.
• Audiences: biz, ap, vendor, policy.
• Country codes: ISO 3166-1 alpha-2 lowercase.

Examples

# List
curl https://peppolnews.com/api/v1/articles?section=mandates

# One article
curl https://peppolnews.com/api/v1/articles/<slug>

# One spec
curl https://peppolnews.com/api/v1/specs/peppol-bis-billing-3

# Country dossier
curl https://peppolnews.com/api/v1/countries/be

# Source registry
curl https://peppolnews.com/api/v1/sources

# Markdown twin
curl -H 'Accept: text/markdown' https://peppolnews.com/2026/06/<slug>/

# NLWeb ask
curl -X POST https://peppolnews.com/ask -d '{"query":"ViDA status in 2026"}'

Data shapes

Article

{
  "slug": "string",
  "title": "string",
  "kicker": "string",
  "dek": "string",
  "publishedAt": "ISO 8601 UTC",
  "section": "mandates|network|vendors|policy|specs|guides",
  "audience": ["biz" | "ap" | "vendor" | "policy"],
  "countries": ["be", "de", ...],
  "tags": ["string"],
  "sources": [{ "name": "string", "url": "string" }],
  "url": "string"
}

Error

{
  "error": {
    "code": "not_found",
    "message": "Article slug 'foo' not found",
    "hint": "List /api/v1/articles to discover valid slugs."
  }
}

References

• /api/llms.txt — API surface summary.
• /developers/llms.txt — developer-portal summary.
• /openapi.json — OpenAPI 3.1 spec.
• /auth.md — agent auth walkthrough.
• /pricing.md — pricing.