---
title: "Lookup Peppol participants"
method: GET
path: "/api/lookup/participants"
tags: ["Lookup"]
---

# Lookup Peppol participants

`GET /api/lookup/participants`

Lookup Peppol participants by name or other identifiers. You can limit the search to a specific country by providing the country code.

## Query parameters

- `query` string, required — Query to lookup
- `country_code` string, nullable — Country code of the company to lookup. If not provided, the search will be global.

## Response `200`

Successful Response

- PeppolSearchResult — Represents the result of a Peppol directory search
  - `total_count` integer, required — Total number of results
  - `used_count` integer, required — Number of results returned by the API
  - `participants` PeppolParticipant[] — List of participants
    - `peppol_id` string, required — Peppol ID of the participant
    - `peppol_scheme` string, required — Peppol scheme of the participant
    - `entities` PeppolEntity[] — List of business entities
      - `name` string, nullable — Business entity name
      - `country_code` string, nullable — Country code
      - `website` string, nullable — Website URL
      - `geo_info` string, nullable — Geographic information
      - `additional_info` string, nullable — Additional information
      - `registration_date` string, nullable — Registration date
      - `identifiers` PeppolIdentifier[] — List of business identifiers
        - `scheme` string, required — Identifier scheme
        - `value` string, required — Identifier value
    - `document_types` PeppolDocumentType[] — List of supported document types
      - `scheme` string, required — Document type scheme
      - `value` string, required — Document type value
  - `query_terms` string, required — Query terms used for search
  - `search_date` string, required — Search date of the result

## Other responses

- `422` — Unprocessable Entity: Invalid query
- `500` — Internal Server Error: Unexpected server error

---

[API](https://skmtc.net/e-invoice-be/apis/e-invoice-be-peppol-access-point-api.md) · [All operations](https://skmtc.net/e-invoice-be/apis/e-invoice-be-peppol-access-point-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/e-invoice-be/e-invoice-be-peppol-access-point-api/revisions/a5b8396effe8/schema)