Developer-Friendly Peppol Integration
The Peppox API lets you integrate Peppol e-invoicing in minutes, not weeks. Connect your ERP, accounting system or SaaS platform through one simple, unified REST API — no SOAP, no complexity.
Get API Access
With Peppox, you can administer all your clients from one secure, user-friendly interface.
Create a dedicated Company account for each client you manage and use the same simple API to send and receive their Peppol invoices and credit notes — without becoming or registering with an Access Point.
Example: if your ERP hosts multiple companies/clients, create a Peppox Company account for each one and connect our API to deliver and receive documents on their behalf.
Connect Your Way — Managed Access Point or Your Own
We make life easier for developers and integrators. If you don’t have a Peppol Access Point yet, start sending Peppol-compliant invoices today using the Peppox Managed Access Point — no complex onboarding.
Already have an Access Point? Simply link your credentials and certificates in our secure dashboard and you’re set. In both cases, you use the same Peppox API and endpoints — no code changes.
Bring Your Own Access Point
Keep your current provider and connect it in minutes — no rewrite, no migration headaches.
- Securely store credentials and certificates in the dashboard
- No code change — same endpoints and payloads
- Unified logs, delivery tracking, and error visibility
No Access Point Yet?
Use the Peppox Managed Access Point and send your first invoice in two clicks.
- No separate AP contracts or lengthy onboarding
- High-performance, secure routing to the Peppol network
- UBL / PEPPOL BIS validation and PDF attachment support
managed or linked in configuration — endpoints stay identical.
Switch Access Points anytime from the dashboard — keep your API calls the same, just update configuration.
One API. Infinite Integrations.
Peppox abstracts all Peppol complexity.
You send JSON — we handle XML validation, certificate authentication and access point routing automatically.
🔑 Secure Authentication
Connect with your API key — each request is scoped and encrypted for your account only.
📤 Invoice Endpoint
Send invoices using POST /v1/invoices/send — we deliver it to the correct Access Point.
📡 Webhooks
Receive asynchronous notifications for delivery confirmations, rejections or errors.
🧰 SDKs
Use ready-made SDKs for PHP, Python or Node.js — save days of development.
Example Request — Sending an Invoice
A simple example using cURL. Replace your credentials and Peppox will automatically validate and deliver the invoice to the correct Access Point.
curl -X POST https://api.peppox.com/v1/invoices/send \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"access_point": "auto",
"invoice": {
"invoiceNumber": "INV-2025-1001",
"issueDate": "2025-10-12",
"currency": "EUR",
"buyer": {
"vat": "BE0123456789"
},
"seller": {
"vat": "BE0987654321"
},
"lines": [
{
"description": "Software Development",
"amount": 1250.00
},
{
"description": "Support Services",
"amount": 350.00
}
],
"attachments": [
{
"type": "pdf",
"fileBase64": "JVBERi0xLjQKJeLjz9M..."
}
]
}
}'
✅ The same call works with any Access Point — Peppox handles the routing.
API Endpoints Overview
| Endpoint | Description | Method |
|---|---|---|
/v1/invoice/add |
Create a new invoice header and store supplier, customer, and payment details. | POST |
/v1/invoice_line/add/{id} |
Add one or multiple product or service lines to an existing invoice. | POST |
/v1/invoice_attach_pdf/add |
Attach a PDF document to an existing invoice using upload, Base64, or remote URL. | POST |
/v1/xml/generate |
Generate a Peppol-compliant UBL XML file combining the invoice, its lines, and attachments. | POST |
/v1/webhooks/register |
Register a webhook to receive delivery updates | POST |