# Peppol participant lookup

Source: https://veriport.io/docs/peppol (published 2026-10-24)

Looks a participant up on the Peppol network as an access point does before it sends: the SML (DNS, U-NAPTR, zone `participant.sml.prod.tech.peppol.org`) says whether the identifier is registered and which SMP serves it; the SMP lists the document types it receives; the Peppol Directory adds the registered name when the participant's provider published a business card. `id` is a participant identifier (`0208:0202239951`, the ICD and the value; the `iso6523-actorid-upis::` prefix is optional) or a Belgian enterprise or VAT number in any usual form, which is looked up under both 0208 (enterprise number) and 9925 (VAT number) and checked against its mod-97 digits first. `receives` answers the sender's question for Peppol BIS Billing 3.0 (invoice, credit note), across every identifier; it is null when a registered participant's SMP did not answer and the others do not settle it. « Not registered » is an answer (200, counted). Answers are cached 6 hours (a registration takes up to a day to reach every resolver) and served marked `stale` up to 72 hours when the SML does not answer; otherwise 503, not counted. Discovery only: nothing is sent on the network.

## GET https://veriport.io/api/v1/peppol/participant

Looks a participant up on the Peppol network as an access point does before it sends: the SML (DNS, U-NAPTR, zone `participant.sml.prod.tech.peppol.org`) says whether the identifier is registered and which SMP serves it; the SMP lists the document types it receives; the Peppol Directory adds the registered name when the participant's provider published a business card. `id` is a participant identifier (`0208:0202239951`, the ICD and the value; the `iso6523-actorid-upis::` prefix is optional) or a Belgian enterprise or VAT number in any usual form, which is looked up under both 0208 (enterprise number) and 9925 (VAT number) and checked against its mod-97 digits first. `receives` answers the sender's question for Peppol BIS Billing 3.0 (invoice, credit note), across every identifier; it is null when a registered participant's SMP did not answer and the others do not settle it. « Not registered » is an answer (200, counted). Answers are cached 6 hours (a registration takes up to a day to reach every resolver) and served marked `stale` up to 72 hours when the SML does not answer; otherwise 503, not counted. Discovery only: nothing is sent on the network.

Tiers: anonymous, free, credits, plan. Cost: 1 call (cached or live); 0 on 400 or 503.

- `id` (query, required): A Peppol participant identifier (ICD:value) or a Belgian enterprise or VAT number.

Example 200:

```json
{
  "query": {
    "kind": "be_enterprise",
    "value": "0202239951"
  },
  "registered": true,
  "receives": {
    "invoice": true,
    "creditNote": true
  },
  "participants": [
    {
      "id": "iso6523-actorid-upis::0208:0202239951",
      "registered": true,
      "smp": "https://smp.tickstar.com/peppol/",
      "documentTypes": [
        {
          "id": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1",
          "label": "Peppol BIS Billing 3.0 invoice",
          "billing": "invoice"
        },
        {
          "id": "urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2::CreditNote##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1",
          "label": "Peppol BIS Billing 3.0 credit note",
          "billing": "credit_note"
        }
      ]
    },
    {
      "id": "iso6523-actorid-upis::9925:be0202239951",
      "registered": true,
      "smp": "https://smp.tickstar.com/peppol/",
      "documentTypes": [
        {
          "id": "urn:oasis:names:specification:ubl:schema:xsd:Invoice-2::Invoice##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1",
          "label": "Peppol BIS Billing 3.0 invoice",
          "billing": "invoice"
        },
        {
          "id": "urn:oasis:names:specification:ubl:schema:xsd:CreditNote-2::CreditNote##urn:cen.eu:en16931:2017#compliant#urn:fdc:peppol.eu:2017:poacc:billing:3.0::2.1",
          "label": "Peppol BIS Billing 3.0 credit note",
          "billing": "credit_note"
        }
      ]
    }
  ],
  "businessCard": {
    "name": "Proximus S.A.",
    "countryCode": "BE",
    "registeredOn": "2025-06-02"
  },
  "source": {
    "sml": "participant.sml.prod.tech.peppol.org",
    "directory": true,
    "checkedAt": "2026-11-08T13:15:08Z",
    "cache": {
      "hit": false,
      "ageSeconds": 0,
      "stale": false
    }
  }
}
```

## Read next

- [Free Peppol participant lookup](https://veriport.io/tools/peppol-participant-lookup)
- [Free Peppol BIS validator](https://veriport.io/tools/peppol-validator)
- [Belgium’s e-invoicing mandate: the Peppol checks](https://veriport.io/guides/belgium-peppol-e-invoicing-mandate)
- [Product page: the e-invoice API](https://veriport.io/einvoice-api)