Skip to main content
GET
/
apps
/
peppol
/
v1
/
lookup
Look up a Peppol participant
curl --request GET \
  --url https://api.invopop.com/apps/peppol/v1/lookup \
  --header 'Authorization: Bearer <token>'
{
  "peppol_id": "0002:123456789",
  "found": true
}
Check whether a company is registered and reachable in the Peppol network. Provide either a peppol_id or a vat number — not both. A 200 response with found: false means the participant ID was resolved but is not yet registered in the network. This is not an error.

Authorizations

​
Authorization
string
header
required

Authenticate using a valid Invopop enrollment token in the Bearer scheme.

Example: Authorization: Bearer <token>

Query Parameters

​
peppol_id
string

Full Peppol participant identifier in scheme:value format, e.g. 0002:123456789. Mutually exclusive with vat.

Example:

"0002:123456789"

​
vat
string

VAT number prefixed with the ISO 3166-1 alpha-2 country code, e.g. FR123456789 or DE123456789. Mutually exclusive with peppol_id.

Example:

"FR123456789"

Response

Lookup completed — check found to determine network presence.

​
peppol_id
string
required

Resolved Peppol participant identifier in scheme:value format. Populated even when found is false.

Example:

"0002:123456789"

​
found
boolean
required

Whether the participant is currently registered in the Peppol network.

Example:

true