Dev api - Peppox

Peppox API v1

Powerful Peppol API for Companies and Integrators

Peppox provides a simple and powerful REST API to connect your invoicing software, ERP, SaaS platform or custom application to the Peppol network.

Send sales invoices, create credit notes, generate UBL XML, attach PDFs, retrieve sent documents, and receive purchase invoices — all through one unified API.

Create a developer account Discover the public API documentation

POST /invoice/add
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "issue_date": "2026-04-28",
  "customer": {
    "endpoint_id": "0208:0123456789",
    "name": "Customer Company",
    "country": "BE"
  }
}

Choose the Right Account for Your Integration

Peppox is available for both integrators and individual companies. Whether you manage multiple clients or only your own company, the same API gives you access to Peppol.

🧩

Integrator Account

Built for developers, SaaS platforms, ERP providers, accountants, and IT companies that need to connect several companies to Peppol from one central account.

Link and manage multiple companies
Centralize Peppol sending and receiving
Use one technical integration for all customers
Monitor documents, statuses, logs and errors
Ideal for ERP, SaaS, accounting and automation platforms

Create an integrator account

🏢

Company Account

Perfect for a single company that wants to send and receive Peppol invoices directly from its own software, website, ERP or internal application.

Send your own sales invoices through Peppol
Create and send credit notes
Receive purchase invoices from suppliers
Retrieve sent invoices and verify Peppol status
Simple API key authentication

Create a company account

Same API. Different usage. Integrators can manage multiple companies, while company accounts can use the API for their own Peppol documents.

Everything You Need to Automate Peppol E-Invoicing

Peppox simplifies every step of electronic invoicing: document creation, XML generation, PDF attachment, Peppol delivery, status tracking and purchase invoice retrieval.

📤 Send Sales Invoices

Create invoice headers, add invoice lines, attach a PDF and generate Peppol-compliant XML from your data.

🧾 Create Credit Notes

Generate and send credit notes with the same simple workflow used for sales invoices.

📄 Generate UBL XML

Convert your invoice or credit note data into Peppol-compliant UBL XML directly from the API.

📎 Attach PDF Files

Attach invoice or credit note PDFs using upload, Base64 content or a remote HTTPS file URL.

📬 Retrieve Sent Documents

List sent invoice headers and lines to verify delivery, Peppol status, customer data and document history.

📥 Receive Purchase Invoices

Retrieve purchase invoice headers and lines received through Peppol from your suppliers.

🔍 Search, Filter and Sort

Use filters by date, status, document type, keyword, pagination and sorting on sent and received documents.

🔐 API Key Authentication

Authenticate securely with your Peppox API key using bearer authorization or API key parameters.

A Simple Workflow for Developers

Peppox is designed to be easy to integrate. You create the document, add the lines, attach the PDF if needed, generate the XML, and Peppox handles the Peppol connection.

1

Create the document

Add a sales invoice or credit note header with customer, payment and delivery information.

2

Add document lines

Add products, services, quantities, prices, VAT rates and item references.

3

Attach a PDF

Upload a PDF, send it as Base64 or provide a secure remote URL.

4

Generate XML

Peppox builds the Peppol-compliant UBL XML document.

5

Track and retrieve

Follow sent documents and retrieve purchase invoices received through Peppol.

Main API Endpoints

The Peppox API is organized into clear endpoints for invoice management, credit notes, XML generation, sent documents and received purchase invoices.

POST

/invoice/add

Create a sales invoice header in draft status.

POST

/invoice_line/add

Add a line to an existing sales invoice.

POST

/invoice_attach_pdf/add

Attach a PDF file to an existing sales invoice.

POST

/xml/generate

Generate a Peppol-compliant UBL XML file.

POST

/creditnote/add

Create a credit note header.

POST

/creditnote_line/add

Add a line to an existing credit note.

GET

/doc-sent/header/list

List sent invoice headers with filters and Peppol status.

GET

/doc-sent/lines/list

Retrieve the lines of a sent invoice.

GET

/doc-received/header/list

List received purchase invoice headers.

GET

/doc-received/lines/list

Retrieve the lines of a received purchase invoice.

Public API Documentation

Explore the Peppox API Documentation

The Peppox API documentation is publicly available for developers, integrators and companies. Visit the API page to discover all available endpoints, request examples, parameters and responses.

Whether you want to send sales invoices, create credit notes, retrieve sent documents or receive purchase invoices, the documentation helps you understand how to connect your software to Peppol with Peppox.

Visit the API documentation

Clean JSON, Simple Requests

Peppox accepts clean JSON payloads and standard HTTP requests. Developers can quickly integrate Peppol sending and receiving into existing platforms without learning multiple provider-specific APIs.

REST API with JSON payloads
Simple API key authentication
Clear document GUIDs for tracking
Compatible with PHP, Python, Node.js, Java, .NET and any HTTP client

Create a sales invoice

curl -X POST "https://api.peppox.com/invoice/add/" \

  -H "Authorization: Bearer YOUR_API_KEY" \

  -H "Content-Type: application/json" \

  -d '{

    "issue_date": "2026-04-28",

    "due_date": "2026-05-28",

    "currency": "EUR",

    "customer": {

      "endpoint_id": "0208:0123456789",

      "name": "Customer Company",

      "country": "BE"

    }

  }'

List received purchase invoices

curl "https://api.peppox.com/doc-received/header/list/?supplier_id=YOUR_SUPPLIER_ID"

Send, Receive and Verify Peppol Documents

Peppox is not limited to sending invoices. Your application can also retrieve what was sent, verify document statuses, and import purchase invoices received from suppliers.

For outgoing documents

Your application can send sales invoices and credit notes, then verify the delivery status and retrieve document history whenever needed.

Sales invoice headers and lines
Credit note headers and lines
PDF attachments
UBL XML generation
Sent document listing and Peppol status verification

For incoming documents

Your application can retrieve purchase invoices received through Peppol and import them into your ERP, accounting system or internal validation workflow.

Received purchase invoice headers
Received purchase invoice lines
Supplier and customer information
VAT totals, payable amount and payment details
Search by date, status, document type and keyword

Start building today

Connect Your Software to Peppol With One API

Create an integrator account to connect multiple companies, or create a company account to send and receive your own Peppol documents directly through Peppox.

Create an integrator account Create a company account