Peppol Directory API
Commercialby OpenPeppol AISBL
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
- 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"}]}]}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