Menu

Peppol participant lookup

Before you send a Peppol invoice, check that the customer can receive it. Give a Belgian enterprise or VAT number (or any Peppol ID) and this page asks the Peppol network the way an access point does: the SML says whether the company is registered and which provider serves it, the provider’s SMP lists the documents it receives, the Peppol Directory adds its registered name. No account, 20 lookups a day.

Look a company up on Peppol

BE 0202.239.951, 0202239951 or 0208:0202239951. A Belgian number is looked up under 0208 (enterprise number) and 9925 (VAT number).

What each answer means

AnswerWhat to do
On Peppol: you can send it invoicesSend through your access point to the identifier shown. Check the file first: an access point refuses a file that breaks the Peppol rules.
On Peppol, but not for every documentUsually: invoices yes, credit notes not listed. Ask the customer how they want corrections, or whether their provider can add credit notes.
Not found on PeppolAsk the customer for the identifier their provider registered (some register only the VAT number, or another scheme). Registered today? Wait up to a day for DNS.
On Peppol; its provider did not say which documentsThe provider’s server did not answer. Try again later.

For developers

This page calls GET https://veriport.io/api/v1/peppol/participant?id=… without a key. With a free key, 100 calls a month, a lookup is 1 call; the answer has registered, receives.invoice, receives.creditNote, each identifier with its SMP and document types, and the Directory’s business card. The SDKs (peppolParticipant, peppol_participant) and the MCP server (peppol_participant) call it too.

Questions

Where does the answer come from?
From the Peppol network itself: the SML (a DNS zone OpenPeppol operates), the participant’s SMP (its provider’s metadata server) and the Peppol Directory. Veriport is not affiliated with OpenPeppol; « Peppol » is used descriptively.
The company is not found, but it says it is on Peppol.
It may be registered under another identifier (another scheme, or a VAT number in another format), or the registration may be less than a day old. Ask for their Peppol ID exactly as their provider registered it and look that up.
Is this a directory of all Belgian businesses?
No. It answers for one identifier at a time, live; the name appears only when the company’s provider published a business card in the Peppol Directory.

Check customers from your own code: 100 free calls a month, then from $9.

Get a free key

Sources