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.

POST/peppol/companies

Onboard 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.

FieldTypeDescription
enterpriseNumber*stringThe Belgian enterprise number (KBO/BCE), any usual form: 0202239951, BE 0202.239.951, the 9-digit form.
name*string
vatNumberstring | nullBE followed by the enterprise number, when the company is registered for VAT.
address*object
address.streetstring
address.postalCodestring
address.citystring
emailstring | null (email)Where the access point may write to the company about its identity check. Passed on, not stored by Veriport.
mandate*object
mandate.acceptedboolean
mandate.versionstringThe mandate version in force; its text is in the description of POST /peppol/companies.
mandate.signatoryNamestringThe person accepting on behalf of the company.
mandate.signatoryCapacity"director" | "power_of_attorney"
application/json
{
  "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
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.

FieldTypeDescription
id*stringpc_…
enterpriseNumber*string
participantId*stringThe Peppol sender identifier, 0208:<enterprise number>.
name*string
vatNumber*string | null
address*object
address.streetstring
address.postalCodestring
address.citystring
address.countryCodestring
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 | nullWhile pending: where the representative completes the identity check.
mandate*object
mandate.versionstring
mandate.textSha256stringSHA-256 of the exact mandate text accepted.
mandate.acceptedAtstring (date-time)
mandate.signatoryNamestring
mandate.signatoryCapacity"director" | "power_of_attorney"
mandate.signaturestringhmac-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.
  • 400invalid_parameter — A parameter is missing or malformed.
  • 401unauthorized — The API key is missing, unknown or revoked.
  • 403forbidden_for_tier — This option is not included in your tier.
  • 409peppol_company_taken — This company is onboarded by another account.
  • 429rate_limited — Too many requests per second.
  • 503peppol_sending_unavailable — Peppol sending is not open on this deployment. upstream_unavailable — The public registry did not answer and no cached answer exists.
GET/peppol/companies

List your sending companies

The companies onboarded on your account, newest first, withdrawn ones included. Any key; not counted.

Tiers
freecreditsplan
Cost
free

Request

curl
curl -H "Authorization: Bearer vp_live_YOUR_KEY" "https://veriport.io/api/v1/peppol/companies"

Response 200

The companies.

FieldTypeDescription
companies*PeppolCompany[]

Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, X-Quota-Remaining, X-Tier.

Errors

  • 401unauthorized — The API key is missing, unknown or revoked.
  • 429rate_limited — Too many requests per second.
GET/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

NameInTypeDescription
id*pathstringThe company id (pc_…).

Request

curl
curl -H "Authorization: Bearer vp_live_YOUR_KEY" "https://veriport.io/api/v1/peppol/companies/id"

Response 200

The company.

FieldTypeDescription
id*stringpc_…
enterpriseNumber*string
participantId*stringThe Peppol sender identifier, 0208:<enterprise number>.
name*string
vatNumber*string | null
address*object
address.streetstring
address.postalCodestring
address.citystring
address.countryCodestring
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 | nullWhile pending: where the representative completes the identity check.
mandate*object
mandate.versionstring
mandate.textSha256stringSHA-256 of the exact mandate text accepted.
mandate.acceptedAtstring (date-time)
mandate.signatoryNamestring
mandate.signatoryCapacity"director" | "power_of_attorney"
mandate.signaturestringhmac-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

  • 401unauthorized — The API key is missing, unknown or revoked.
  • 404not_found — No such resource.
  • 429rate_limited — Too many requests per second.
DELETE/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

NameInTypeDescription
id*pathstringThe company id (pc_…).

Request

curl
curl -H "Authorization: Bearer vp_live_YOUR_KEY" "https://veriport.io/api/v1/peppol/companies/id"

Response 200

Withdrawn.

FieldTypeDescription
id*stringpc_…
enterpriseNumber*string
participantId*stringThe Peppol sender identifier, 0208:<enterprise number>.
name*string
vatNumber*string | null
address*object
address.streetstring
address.postalCodestring
address.citystring
address.countryCodestring
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 | nullWhile pending: where the representative completes the identity check.
mandate*object
mandate.versionstring
mandate.textSha256stringSHA-256 of the exact mandate text accepted.
mandate.acceptedAtstring (date-time)
mandate.signatoryNamestring
mandate.signatoryCapacity"director" | "power_of_attorney"
mandate.signaturestringhmac-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

  • 401unauthorized — The API key is missing, unknown or revoked.
  • 404not_found — No such resource.
  • 429rate_limited — Too many requests per second.
POST/peppol/companies/{id}/verification

A 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

NameInTypeDescription
id*pathstringThe company id (pc_…).

Request

curl
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.

FieldTypeDescription
id*stringpc_…
enterpriseNumber*string
participantId*stringThe Peppol sender identifier, 0208:<enterprise number>.
name*string
vatNumber*string | null
address*object
address.streetstring
address.postalCodestring
address.citystring
address.countryCodestring
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 | nullWhile pending: where the representative completes the identity check.
mandate*object
mandate.versionstring
mandate.textSha256stringSHA-256 of the exact mandate text accepted.
mandate.acceptedAtstring (date-time)
mandate.signatoryNamestring
mandate.signatoryCapacity"director" | "power_of_attorney"
mandate.signaturestringhmac-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

  • 401unauthorized — The API key is missing, unknown or revoked.
  • 404not_found — No such resource.
  • 409peppol_company_not_ready — The sending company cannot send yet.
  • 429rate_limited — Too many requests per second.
  • 503peppol_sending_unavailable — Peppol sending is not open on this deployment. upstream_unavailable — The public registry did not answer and no cached answer exists.
POST/peppol/documents

Send 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

NameInTypeDescription
Idempotency-Key*headerstringYour identifier for this document (1–128 letters, digits, -, _, ., :), such as your invoice id.

Request body

Media types: application/json.

FieldTypeDescription
companyId*stringAn active company of your account (pc_…).
invoice*InvoiceInputThe invoice (EN 16931 business terms named in each field). Strict: an unknown field is refused, never ignored.

Request

curl
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.

FieldTypeDescription
id*stringpd_…
companyId*string
documentType*"invoice" | "credit_note"
number*stringBT-1.
issueDate*string (date)
sender*stringThe sender’s participant identifier.
receiver*stringThe receiver’s participant identifier (the buyer’s electronic address).
currency*string
payableAmount*stringBT-115, two decimals.
file*object
file.sha256stringSHA-256 of the UBL file handed to the access point (the file itself is not kept).
file.bytesinteger
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.categorystringThe access point’s category: validation, recipient_not_found, document_not_supported, transport, recipient_rejected, duplicate, unconfirmed, other.
failure.messagestring
billing*object | null
billing.callsinteger
billing.billedAtstring (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, or pending the receiver’s acknowledgement.
  • 202Handed over without an answer (unconfirmed): settled by Veriport, never sent twice.
  • 400invalid_parameter — A parameter is missing or malformed.
  • 401unauthorized — The API key is missing, unknown or revoked.
  • 402quota_exceeded — Monthly allowance and credits are used up.
  • 403forbidden_for_tier — This option is not included in your tier.
  • 404not_found — No such resource.
  • 409peppol_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.
  • 413payload_too_large — Too many rows or too many bytes.
  • 422einvoice_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.
  • 429rate_limited — Too many requests per second.
  • 503peppol_sending_unavailable — Peppol sending is not open on this deployment. upstream_unavailable — The public registry did not answer and no cached answer exists.
GET/peppol/documents

List the documents you sent

Your account’s documents, newest first, optionally one company’s. Any key; not counted.

Tiers
freecreditsplan
Cost
free

Parameters

NameInTypeDescription
companyIdquerystringOnly this company’s documents (pc_…).
limitqueryintegerDocuments per page.
cursorquerystringThe nextCursor of the previous page.

Request

curl
curl -H "Authorization: Bearer vp_live_YOUR_KEY" "https://veriport.io/api/v1/peppol/documents"

Response 200

One page of documents.

FieldTypeDescription
documents*PeppolDocument[]
nextCursor*string | null

Headers: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, RateLimit-Policy, X-Quota-Remaining, X-Tier.

Errors

  • 400invalid_parameter — A parameter is missing or malformed.
  • 401unauthorized — The API key is missing, unknown or revoked.
  • 429rate_limited — Too many requests per second.
GET/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

NameInTypeDescription
id*pathstringThe document id (pd_…).

Request

curl
curl -H "Authorization: Bearer vp_live_YOUR_KEY" "https://veriport.io/api/v1/peppol/documents/id"

Response 200

The document.

FieldTypeDescription
id*stringpd_…
companyId*string
documentType*"invoice" | "credit_note"
number*stringBT-1.
issueDate*string (date)
sender*stringThe sender’s participant identifier.
receiver*stringThe receiver’s participant identifier (the buyer’s electronic address).
currency*string
payableAmount*stringBT-115, two decimals.
file*object
file.sha256stringSHA-256 of the UBL file handed to the access point (the file itself is not kept).
file.bytesinteger
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.categorystringThe access point’s category: validation, recipient_not_found, document_not_supported, transport, recipient_rejected, duplicate, unconfirmed, other.
failure.messagestring
billing*object | null
billing.callsinteger
billing.billedAtstring (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

  • 401unauthorized — The API key is missing, unknown or revoked.
  • 404not_found — No such resource.
  • 429rate_limited — Too many requests per second.