---
title: "Look up a Peppol participant"
method: GET
path: "/apps/peppol/v1/lookup"
---

# Look up a Peppol participant

`GET /apps/peppol/v1/lookup`

Checks whether a company is registered and reachable in the Peppol
network. Exactly one of `peppol_id` or `vat` must be provided.

When `vat` is used, the service derives the Peppol participant
identifier using the country-specific scheme rules (e.g. `9920:` for
Spain, `0208:` for Belgium). If no scheme can be determined for
the given country the request will fail with `400 Bad Request`.

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

## Query parameters

- `peppol_id` string
- `vat` string

## Response `200`

Lookup completed — check `found` to determine network presence.

- LookupResponse
  - `peppol_id` string, required — Resolved Peppol participant identifier in `scheme:value` format. Populated even when `found` is `false`.
  - `found` boolean, required — Whether the participant is currently registered in the Peppol network.

## Other responses

- `400` — The request is malformed or missing required parameters.
- `401` — Missing or invalid authentication token.
- `500` — An unexpected server-side error occurred.

---

[API](https://skmtc.net/invopop/apis/access-service-api.md) · [All operations](https://skmtc.net/invopop/apis/access-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/invopop/access-service-api/versions/fc954f96ea62/schema)