---
title: "Validate Peppol ID"
method: GET
path: "/api/validate/peppol-id"
tags: ["Validate"]
---

# Validate Peppol ID

`GET /api/validate/peppol-id`

Validate if a Peppol ID exists in the Peppol network and retrieve supported document types. The peppol_id must be in the form of `<scheme>:<id>`. The scheme is a 4-digit code representing the identifier scheme, and the id is the actual identifier value. For example, for a Belgian company it is `0208:0123456789` (where 0208 is the scheme for Belgian enterprises, followed by the 10 digits of the official BTW / KBO number).

## Query parameters

- `peppol_id` string, required — Peppol ID in the format `<scheme>:<id>`. Example: `0208:1018265814` for a Belgian company.

## Response `200`

Successful Response

- PeppolIdValidationResponse — Response for a Peppol ID validation request. This model represents the validation result of a Peppol ID in the Peppol network, including whether the ID is valid and what document types it supports.
  - `is_valid` boolean, required — Whether the Peppol ID is valid and registered in the Peppol network
  - `dns_valid` boolean, required — Whether the DNS resolves to a valid SMP
  - `business_card_valid` boolean, required — Whether a business card is set at the SMP
  - `supported_document_types` string[]
  - `business_card` AppSchemasValidationBusinessCard, required
    - `name` string, nullable
    - `country_code` string, nullable
    - `registration_date` string, date, nullable

## Other responses

- `422` — Unprocessable Entity: Invalid Peppol ID format
- `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/versions/a5b8396effe8/schema)
