Peppol sending for Belgian companies
Registers a Belgian company as a sender at Veriport's Peppol access point, under your account: one key can onboard many companies (software vendors). Give its enterprise number (any usual form; checked against its mod-97 digits), name, address and, optionally, its VAT number (BE + the enterprise number) and a contact e-mail (passed to the access point for the identity check, not stored by Veriport). The company is registered as a sender only: it is not published as a receiver, so wherever it receives its Peppol documents today stays unchanged.
The mandate. mandate records that the company authorises the sending: accepted: true, the version in force (2026-11-17), the name of the person accepting and their capacity (director, power_of_attorney). The record keeps the version, the SHA-256 of its exact text, the time, the key and a salted hash of the address, signed with an HMAC (mandate.signature, your receipt). The text:
> The company identified in this onboarding (the Company) authorises Janolab Studio LLC, which operates Veriport (https://veriport.io), and the certified Peppol access point Veriport uses as its subcontractor, to:
>
> 1. register the Company with that access point as a sender on the Peppol network under its Belgian enterprise number (scheme 0208), without publishing it as a receiver, so that its current way of receiving documents is not changed;
>
> 2. transmit over Peppol, in the Company's name, the invoices and credit notes submitted to Veriport for the Company under the API account that recorded this mandate;
>
> 3. have the access point verify the identity of the Company's representative, as the access point requires before a company may send.
>
> The person accepting declares that they may bind the Company (as a director or under a power of attorney) and that the data given for the Company is correct. The Company remains responsible for the content of each document it sends.
>
> The Company may withdraw this mandate at any time, through the API (DELETE /peppol/companies/{id}) or by writing to hello@veriport.io; documents already transmitted remain transmitted. This mandate is governed by the terms of service at https://veriport.io/terms.
The identity check. The access point verifies the company's representative before it may send (matched against the Belgian company register): the answer is pending_verification with verificationUrl, which the representative opens; the company becomes active when the access point confirms it (read it again, or wait for the next send). Onboarding the same enterprise number again on the same account answers the existing company (200); a company onboarded by another account is 409 peppol_company_taken. Not counted; prepaid credits or the monthly plan.
/peppol/companiesOnboard a Belgian company to send over Peppol
Registers a Belgian company as a sender at Veriport's Peppol access point, under your account: one key can onboard many companies (software vendors). Give its enterprise number (any usual form; checked against its mod-97 digits), name, address and, optionally, its VAT number (BE + the enterprise number) and a contact e-mail (passed to the access point for the identity check, not stored by Veriport). The company is registered as a sender only: it is not published as a receiver, so wherever it receives its Peppol documents today stays unchanged.
The mandate. mandate records that the company authorises the sending: accepted: true, the version in force (2026-11-17), the name of the person accepting and their capacity (director, power_of_attorney). The record keeps the version, the SHA-256 of its exact text, the time, the key and a salted hash of the address, signed with an HMAC (mandate.signature, your receipt). The text:
> The company identified in this onboarding (the Company) authorises Janolab Studio LLC, which operates Veriport (https://veriport.io), and the certified Peppol access point Veriport uses as its subcontractor, to:
>
> 1. register the Company with that access point as a sender on the Peppol network under its Belgian enterprise number (scheme 0208), without publishing it as a receiver, so that its current way of receiving documents is not changed;
>
> 2. transmit over Peppol, in the Company's name, the invoices and credit notes submitted to Veriport for the Company under the API account that recorded this mandate;
>
> 3. have the access point verify the identity of the Company's representative, as the access point requires before a company may send.
>
> The person accepting declares that they may bind the Company (as a director or under a power of attorney) and that the data given for the Company is correct. The Company remains responsible for the content of each document it sends.
>
> The Company may withdraw this mandate at any time, through the API (DELETE /peppol/companies/{id}) or by writing to hello@veriport.io; documents already transmitted remain transmitted. This mandate is governed by the terms of service at https://veriport.io/terms.
The identity check. The access point verifies the company's representative before it may send (matched against the Belgian company register): the answer is pending_verification with verificationUrl, which the representative opens; the company becomes active when the access point confirms it (read it again, or wait for the next send). Onboarding the same enterprise number again on the same account answers the existing company (200); a company onboarded by another account is 409 peppol_company_taken. Not counted; prepaid credits or the monthly plan.
- Tiers
- creditsplan
- Cost
- free
Request body
Media types: application/json.
| Field | Type | Description |
|---|---|---|
| enterpriseNumber* | string | The Belgian enterprise number (KBO/BCE), any usual form: 0202239951, BE 0202.239.951, the 9-digit form. |
| name* | string | |
| vatNumber | string | null | BE followed by the enterprise number, when the company is registered for VAT. |
| address* | object | |
| address.street | string | |
| address.postalCode | string | |
| address.city | string | |
| string | null (email) | Where the access point may write to the company about its identity check. Passed on, not stored by Veriport. | |
| mandate* | object | |
| mandate.accepted | boolean | |
| mandate.version | string | The mandate version in force; its text is in the description of POST /peppol/companies. |
| mandate.signatoryName | string | The person accepting on behalf of the company. |
| mandate.signatoryCapacity | "director" | "power_of_attorney" |
{
"enterpriseNumber": "BE 0202.239.951",
"name": "Exemple Belgique SA",
"vatNumber": "BE0202239951",
"address": {
"street": "Rue de la Loi 16",
"postalCode": "1000",
"city": "Bruxelles"
},
"email": "facturation@exemple.be",
"mandate": {
"accepted": true,
"version": "2026-11-17",
"signatoryName": "Marie Dupont",
"signatoryCapacity": "director"
}
}Request
curl -X POST -H "Authorization: Bearer vp_live_YOUR_KEY" -H "Content-Type: application/json" \
-d '{"enterpriseNumber":"BE 0202.239.951","name":"Exemple Belgique SA","vatNumber":"BE0202239951","address":{"street":"Rue de la Loi 16","postalCode":"1000","city":"Bruxelles"},"email":"facturation@exemple.be","mandate":{"accepted":true,"version":"2026-11-17","signatoryName":"Marie Dupont","signatoryCapacity":"director"}}' \
"https://veriport.io/api/v1/peppol/companies"Response 200
Already onboarded on this account: the existing company.
| Field | Type | Description |
|---|---|---|
| id* | string | pc_… |
| enterpriseNumber* | string | |
| participantId* | string | The Peppol sender identifier, 0208:<enterprise number>. |
| name* | string | |
| vatNumber* | string | null | |
| address* | object | |
| address.street | string | |
| address.postalCode | string | |
| address.city | string | |
| address.countryCode | string | |
| status* | "pending_verification" | "active" | "withdrawn" | pending_verification: the representative has not completed the access point’s identity check; active: may send; withdrawn: the mandate ended. |
| verificationUrl* | string | null | While pending: where the representative completes the identity check. |
| mandate* | object | |
| mandate.version | string | |
| mandate.textSha256 | string | SHA-256 of the exact mandate text accepted. |
| mandate.acceptedAt | string (date-time) | |
| mandate.signatoryName | string | |
| mandate.signatoryCapacity | "director" | "power_of_attorney" | |
| mandate.signature | string | hmac-sha256:<hex> over the record and the company’s identity: your receipt. |
| createdAt* | string (date-time) | |
| updatedAt* | string (date-time) | |
| withdrawnAt* | string | null (date-time) |
Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, X-Quota-Remaining, X-Tier.
Errors
- 201Onboarded.
- 400
invalid_parameter— A parameter is missing or malformed. - 401
unauthorized— The API key is missing, unknown or revoked. - 403
forbidden_for_tier— This option is not included in your tier. - 409
peppol_company_taken— This company is onboarded by another account. - 429
rate_limited— Too many requests per second. - 503
peppol_sending_unavailable— Peppol sending is not open on this deployment.upstream_unavailable— The public registry did not answer and no cached answer exists.
/peppol/companiesList your sending companies
The companies onboarded on your account, newest first, withdrawn ones included. Any key; not counted.
- Tiers
- freecreditsplan
- Cost
- free
Request
curl -H "Authorization: Bearer vp_live_YOUR_KEY" "https://veriport.io/api/v1/peppol/companies"Response 200
The companies.
| Field | Type | Description |
|---|---|---|
| companies* | PeppolCompany[] |
Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, X-Quota-Remaining, X-Tier.
Errors
- 401
unauthorized— The API key is missing, unknown or revoked. - 429
rate_limited— Too many requests per second.
/peppol/companies/{id}Get one sending company
One company of your account; while its identity check is pending, the access point is asked whether it completed. Any key; not counted.
- Tiers
- freecreditsplan
- Cost
- free
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id* | path | string | The company id (pc_…). |
Request
curl -H "Authorization: Bearer vp_live_YOUR_KEY" "https://veriport.io/api/v1/peppol/companies/id"Response 200
The company.
| Field | Type | Description |
|---|---|---|
| id* | string | pc_… |
| enterpriseNumber* | string | |
| participantId* | string | The Peppol sender identifier, 0208:<enterprise number>. |
| name* | string | |
| vatNumber* | string | null | |
| address* | object | |
| address.street | string | |
| address.postalCode | string | |
| address.city | string | |
| address.countryCode | string | |
| status* | "pending_verification" | "active" | "withdrawn" | pending_verification: the representative has not completed the access point’s identity check; active: may send; withdrawn: the mandate ended. |
| verificationUrl* | string | null | While pending: where the representative completes the identity check. |
| mandate* | object | |
| mandate.version | string | |
| mandate.textSha256 | string | SHA-256 of the exact mandate text accepted. |
| mandate.acceptedAt | string (date-time) | |
| mandate.signatoryName | string | |
| mandate.signatoryCapacity | "director" | "power_of_attorney" | |
| mandate.signature | string | hmac-sha256:<hex> over the record and the company’s identity: your receipt. |
| createdAt* | string (date-time) | |
| updatedAt* | string (date-time) | |
| withdrawnAt* | string | null (date-time) |
Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, X-Quota-Remaining, X-Tier.
Errors
- 401
unauthorized— The API key is missing, unknown or revoked. - 404
not_found— No such resource. - 429
rate_limited— Too many requests per second.
/peppol/companies/{id}Withdraw a company’s mandate
Ends the mandate: nothing more is sent for the company (withdrawn); documents already handed to the access point still settle and stay readable. The company can be onboarded again with a new mandate. Any key; not counted.
- Tiers
- freecreditsplan
- Cost
- free
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id* | path | string | The company id (pc_…). |
Request
curl -H "Authorization: Bearer vp_live_YOUR_KEY" "https://veriport.io/api/v1/peppol/companies/id"Response 200
Withdrawn.
| Field | Type | Description |
|---|---|---|
| id* | string | pc_… |
| enterpriseNumber* | string | |
| participantId* | string | The Peppol sender identifier, 0208:<enterprise number>. |
| name* | string | |
| vatNumber* | string | null | |
| address* | object | |
| address.street | string | |
| address.postalCode | string | |
| address.city | string | |
| address.countryCode | string | |
| status* | "pending_verification" | "active" | "withdrawn" | pending_verification: the representative has not completed the access point’s identity check; active: may send; withdrawn: the mandate ended. |
| verificationUrl* | string | null | While pending: where the representative completes the identity check. |
| mandate* | object | |
| mandate.version | string | |
| mandate.textSha256 | string | SHA-256 of the exact mandate text accepted. |
| mandate.acceptedAt | string (date-time) | |
| mandate.signatoryName | string | |
| mandate.signatoryCapacity | "director" | "power_of_attorney" | |
| mandate.signature | string | hmac-sha256:<hex> over the record and the company’s identity: your receipt. |
| createdAt* | string (date-time) | |
| updatedAt* | string (date-time) | |
| withdrawnAt* | string | null (date-time) |
Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, X-Quota-Remaining, X-Tier.
Errors
- 401
unauthorized— The API key is missing, unknown or revoked. - 404
not_found— No such resource. - 429
rate_limited— Too many requests per second.
/peppol/companies/{id}/verificationA fresh identity-check link
For a company still pending_verification: asks the access point for a new verificationUrl (links can expire). An active company is answered as it is. Any key; not counted.
- Tiers
- freecreditsplan
- Cost
- free
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id* | path | string | The company id (pc_…). |
Request
curl -X POST -H "Authorization: Bearer vp_live_YOUR_KEY" -H "Content-Type: application/octet-stream" \
--data-binary @invoice.xml \
"https://veriport.io/api/v1/peppol/companies/id/verification"Response 200
The company with its new link.
| Field | Type | Description |
|---|---|---|
| id* | string | pc_… |
| enterpriseNumber* | string | |
| participantId* | string | The Peppol sender identifier, 0208:<enterprise number>. |
| name* | string | |
| vatNumber* | string | null | |
| address* | object | |
| address.street | string | |
| address.postalCode | string | |
| address.city | string | |
| address.countryCode | string | |
| status* | "pending_verification" | "active" | "withdrawn" | pending_verification: the representative has not completed the access point’s identity check; active: may send; withdrawn: the mandate ended. |
| verificationUrl* | string | null | While pending: where the representative completes the identity check. |
| mandate* | object | |
| mandate.version | string | |
| mandate.textSha256 | string | SHA-256 of the exact mandate text accepted. |
| mandate.acceptedAt | string (date-time) | |
| mandate.signatoryName | string | |
| mandate.signatoryCapacity | "director" | "power_of_attorney" | |
| mandate.signature | string | hmac-sha256:<hex> over the record and the company’s identity: your receipt. |
| createdAt* | string (date-time) | |
| updatedAt* | string (date-time) | |
| withdrawnAt* | string | null (date-time) |
Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, X-Quota-Remaining, X-Tier.
Errors
- 401
unauthorized— The API key is missing, unknown or revoked. - 404
not_found— No such resource. - 409
peppol_company_not_ready— The sending company cannot send yet. - 429
rate_limited— Too many requests per second. - 503
peppol_sending_unavailable— Peppol sending is not open on this deployment.upstream_unavailable— The public registry did not answer and no cached answer exists.
/peppol/documentsSend an invoice or credit note over Peppol
Sends a Peppol BIS Billing 3.0 invoice or credit note for an active company of your account. The body is companyId and invoice, the same InvoiceInput as /einvoice/create (format peppol-bis, the default). In order, before anything leaves: the file is built and checked like /einvoice/create (schema, CEN and Peppol rules, the Belgian rules; 400 / 422 as there); the seller's electronic address must be the company (0208 + its enterprise number, the default); the buyer's electronic address is the receiver, looked up on the Peppol network (422 peppol_receiver_unreachable when it is not registered or does not receive this document type); a number the company already sent (and that did not fail) is 409 peppol_duplicate_document. Then 100 calls are reserved and the file is handed to the access point.
Idempotency-Key is required: a document sent twice reaches the buyer twice. The same key answers the same document at any later time (200, Idempotent-Replayed: true), with another body 409. Billing: 100 calls a document, once, when the access point confirms delivery to the receiver's access point (delivered); a refused, failed or never-confirmed document costs nothing, and its reserved calls are released.
Answers: 201 delivered (the receiver's access point acknowledged it) or pending (acknowledgement awaited: read it with GET /peppol/documents/{id}); 202 unconfirmed when the access point did not answer: Veriport then asks it for the exact file (its SHA-256) and settles the document within minutes, never sending it twice (a document the access point does not hold after 15 minutes becomes failed); 422 peppol_send_failed (with documentId) when the access point refused or could not deliver it. Only the metadata and the file's SHA-256 are kept (10 years), never the file.
- Tiers
- creditsplan
- Cost
- 100 calls per delivered document, billed on delivery; 0 for a refused, failed or replayed request
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| Idempotency-Key* | header | string | Your identifier for this document (1–128 letters, digits, -, _, ., :), such as your invoice id. |
Request body
Media types: application/json.
| Field | Type | Description |
|---|---|---|
| companyId* | string | An active company of your account (pc_…). |
| invoice* | InvoiceInput | The invoice (EN 16931 business terms named in each field). Strict: an unknown field is refused, never ignored. |
Request
curl -X POST -H "Authorization: Bearer vp_live_YOUR_KEY" -H "Content-Type: application/json" \
-d 'undefined' \
"https://veriport.io/api/v1/peppol/documents"Response 200
A replay of the same Idempotency-Key: the document it sent, in its current state.
| Field | Type | Description |
|---|---|---|
| id* | string | pd_… |
| companyId* | string | |
| documentType* | "invoice" | "credit_note" | |
| number* | string | BT-1. |
| issueDate* | string (date) | |
| sender* | string | The sender’s participant identifier. |
| receiver* | string | The receiver’s participant identifier (the buyer’s electronic address). |
| currency* | string | |
| payableAmount* | string | BT-115, two decimals. |
| file* | object | |
| file.sha256 | string | SHA-256 of the UBL file handed to the access point (the file itself is not kept). |
| file.bytes | integer | |
| status* | "queued" | "unconfirmed" | "pending" | "delivered" | "failed" | queued: being handed over (seconds); unconfirmed: handed over without an answer, being reconciled; pending: accepted, the receiver’s acknowledgement awaited; delivered: acknowledged by the receiver’s access point, billed; failed: not delivered, not billed. |
| failure* | object | null | |
| failure.category | string | The access point’s category: validation, recipient_not_found, document_not_supported, transport, recipient_rejected, duplicate, unconfirmed, other. |
| failure.message | string | |
| billing* | object | null | |
| billing.calls | integer | |
| billing.billedAt | string (date-time) | |
| createdAt* | string (date-time) | |
| updatedAt* | string (date-time) | |
| deliveredAt* | string | null (date-time) |
Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, X-Quota-Remaining, X-Tier.
Errors
- 201Sent:
delivered, orpendingthe receiver’s acknowledgement. - 202Handed over without an answer (
unconfirmed): settled by Veriport, never sent twice. - 400
invalid_parameter— A parameter is missing or malformed. - 401
unauthorized— The API key is missing, unknown or revoked. - 402
quota_exceeded— Monthly allowance and credits are used up. - 403
forbidden_for_tier— This option is not included in your tier. - 404
not_found— No such resource. - 409
peppol_company_not_ready— The sending company cannot send yet.peppol_duplicate_document— This document number was already sent by this company.idempotency_conflict— The Idempotency-Key is in use. - 413
payload_too_large— Too many rows or too many bytes. - 422
einvoice_unsupported— The invoice uses a feature the e-invoice writers do not produce.einvoice_invalid— The invoice breaks the rules of its format.peppol_receiver_unreachable— The receiver cannot receive this document over Peppol.peppol_send_failed— The access point did not deliver the document. - 429
rate_limited— Too many requests per second. - 503
peppol_sending_unavailable— Peppol sending is not open on this deployment.upstream_unavailable— The public registry did not answer and no cached answer exists.
/peppol/documentsList the documents you sent
Your account’s documents, newest first, optionally one company’s. Any key; not counted.
- Tiers
- freecreditsplan
- Cost
- free
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| companyId | query | string | Only this company’s documents (pc_…). |
| limit | query | integer | Documents per page. |
| cursor | query | string | The nextCursor of the previous page. |
Request
curl -H "Authorization: Bearer vp_live_YOUR_KEY" "https://veriport.io/api/v1/peppol/documents"Response 200
One page of documents.
| Field | Type | Description |
|---|---|---|
| documents* | PeppolDocument[] | |
| nextCursor* | string | null |
Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, X-Quota-Remaining, X-Tier.
Errors
- 400
invalid_parameter— A parameter is missing or malformed. - 401
unauthorized— The API key is missing, unknown or revoked. - 429
rate_limited— Too many requests per second.
/peppol/documents/{id}Get a sent document and its delivery status
One document of your account; while it is pending or unconfirmed, the access point is asked for its current state first (and a delivery found is billed then, once). Any key; not counted.
- Tiers
- freecreditsplan
- Cost
- free
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id* | path | string | The document id (pd_…). |
Request
curl -H "Authorization: Bearer vp_live_YOUR_KEY" "https://veriport.io/api/v1/peppol/documents/id"Response 200
The document.
| Field | Type | Description |
|---|---|---|
| id* | string | pd_… |
| companyId* | string | |
| documentType* | "invoice" | "credit_note" | |
| number* | string | BT-1. |
| issueDate* | string (date) | |
| sender* | string | The sender’s participant identifier. |
| receiver* | string | The receiver’s participant identifier (the buyer’s electronic address). |
| currency* | string | |
| payableAmount* | string | BT-115, two decimals. |
| file* | object | |
| file.sha256 | string | SHA-256 of the UBL file handed to the access point (the file itself is not kept). |
| file.bytes | integer | |
| status* | "queued" | "unconfirmed" | "pending" | "delivered" | "failed" | queued: being handed over (seconds); unconfirmed: handed over without an answer, being reconciled; pending: accepted, the receiver’s acknowledgement awaited; delivered: acknowledged by the receiver’s access point, billed; failed: not delivered, not billed. |
| failure* | object | null | |
| failure.category | string | The access point’s category: validation, recipient_not_found, document_not_supported, transport, recipient_rejected, duplicate, unconfirmed, other. |
| failure.message | string | |
| billing* | object | null | |
| billing.calls | integer | |
| billing.billedAt | string (date-time) | |
| createdAt* | string (date-time) | |
| updatedAt* | string (date-time) | |
| deliveredAt* | string | null (date-time) |
Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, X-Quota-Remaining, X-Tier.
Errors
- 401
unauthorized— The API key is missing, unknown or revoked. - 404
not_found— No such resource. - 429
rate_limited— Too many requests per second.