Peppol Directory API
Free public REST API over the OpenPeppol Directory, which indexes business cards of Peppol participants worldwide, including Singapore InvoiceNow registrations under UEN-based identifiers. Query by participant ID, name, country (e.g. country=SG) or registration date and get XML or JSON results. Useful for checking whether a Singapore company is InvoiceNow-registered before sending e-invoices.
How to authenticate
5 stops to a working call
- 1No registration or credentials are required; the REST API is public.
- 2Send HTTP GET requests to /search/1.0/json or /search/1.0/xml (other verbs return 405).
- 3Filter with query parameters such as q, participant, name, country, regdate; multiple parameters are ANDed.
- 4Page results with resultPageIndex/resultPageCount (max 1000 entries total).
- 5Keep under the documented rate limit of 2 queries per second or you will receive HTTP 429.
Example request
curl 'https://directory.peppol.eu/search/1.0/json?country=SG&name=singapore&beautify=true'Example response
{"version":"1.0","total-result-count":4,"matches":[{"participantID":{"scheme":"iso6523-actorid-upis","value":"0195:sguen123456789"},"entities":[{"name":"Example Pte Ltd","countryCode":"SG"}]}]}Peppol Directory API: common questions
Is the Peppol Directory API free?
Yes. OpenPeppol AISBL offers the Peppol Directory API free of charge.
Does the Peppol Directory API need an API key?
No. The Peppol Directory API can be called without an API key or login.
What is the Peppol Directory API endpoint?
The base URL is https://directory.peppol.eu/search/1.0. A working example: curl 'https://directory.peppol.eu/search/1.0/json?country=SG&name=singapore&beautify=true'
What is the Peppol Directory API rate limit?
2 queries per second (HTTP 429 returned above that)
Notes for AI agents
Genuinely free and unauthenticated, but hard rate limited at 2 q/s and capped at 1000 results per query. Participant lookups need the full scheme-prefixed identifier (e.g. iso6523-actorid-upis::0195:...); malformed identifiers return HTTP 400. SG InvoiceNow participants appear under the 0195 (SG UEN) scheme.
Machine-readable version: /api/apis/peppol-directory