curl --request GET \
--url https://api.e-invoice.be/api/lookupconst options = {method: 'GET'};
fetch('https://api.e-invoice.be/api/lookup', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.e-invoice.be/api/lookup"
response = requests.get(url)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.e-invoice.be/api/lookup",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}using RestSharp;
var options = new RestClientOptions("https://api.e-invoice.be/api/lookup");
var client = new RestClient(options);
var request = new RestRequest("");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
{
"queryMetadata": {
"identifierScheme": "iso6523-actorid-upis",
"identifierValue": "0208:1018265814",
"smlDomain": "participant.sml.prod.tech.peppol.org",
"timestamp": "2026-01-12T14:32:10.123456",
"version": "1.0.0"
},
"status": "success",
"errors": [
"DNS lookup failed",
"Business card not available"
],
"dnsInfo": {
"status": "success",
"smlHostname": "participant.sml.prod.tech.peppol.org",
"dnsRecords": [
{
"ip": "193.140.151.175"
}
],
"smpHostname": "smp.e-invoice.be",
"error": "DNS lookup failed: no such domain",
"lookupMethod": "naptr"
},
"serviceMetadata": {
"status": "success",
"queryTimeMs": 245.67,
"endpoints": [
{
"status": "success",
"url": "https://ap.e-invoice.be/as4",
"documentTypes": [
{
"scheme": "busdox-docid-qns",
"value": "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"
}
],
"processes": [
{
"processId": {
"scheme": "cenbii-procid-ubl",
"value": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0"
},
"endpoints": [
{
"transportProfile": "peppol-transport-as4-v2_0",
"address": "https://ap.e-invoice.be/as4",
"serviceActivationDate": "2022-01-01T00:00:00Z",
"serviceExpirationDate": "2025-01-01T00:00:00Z",
"serviceDescription": "Company XYZ's AP service",
"technicalContactUrl": "https://support.e-invoice.be",
"technicalInformationUrl": "https://api.e-invoice.be",
"certificate": {
"status": "success",
"details": {},
"error": "Certificate expired"
}
}
]
}
],
"error": "Connection timeout"
}
],
"error": "Service unavailable"
},
"businessCard": {
"status": "success",
"entities": [
{
"name": "Example Corporation Ltd",
"countryCode": "NO",
"registrationDate": "2021-06-15T00:00:00Z",
"additionalInformation": [
"VAT: BE1018265814",
"Organization number: 1018.265.814"
]
}
],
"queryTimeMs": 123.45,
"error": "Business card not found"
},
"certificates": [
{
"status": "success",
"details": {},
"error": "Certificate expired"
}
],
"executionTimeMs": 895.32
}{
"detail": "<string>"
}{
"detail": "<string>"
}Lookup Peppol ID
Lookup Peppol ID. 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).
curl --request GET \
--url https://api.e-invoice.be/api/lookupconst options = {method: 'GET'};
fetch('https://api.e-invoice.be/api/lookup', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.e-invoice.be/api/lookup"
response = requests.get(url)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.e-invoice.be/api/lookup",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}using RestSharp;
var options = new RestClientOptions("https://api.e-invoice.be/api/lookup");
var client = new RestClient(options);
var request = new RestRequest("");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
{
"queryMetadata": {
"identifierScheme": "iso6523-actorid-upis",
"identifierValue": "0208:1018265814",
"smlDomain": "participant.sml.prod.tech.peppol.org",
"timestamp": "2026-01-12T14:32:10.123456",
"version": "1.0.0"
},
"status": "success",
"errors": [
"DNS lookup failed",
"Business card not available"
],
"dnsInfo": {
"status": "success",
"smlHostname": "participant.sml.prod.tech.peppol.org",
"dnsRecords": [
{
"ip": "193.140.151.175"
}
],
"smpHostname": "smp.e-invoice.be",
"error": "DNS lookup failed: no such domain",
"lookupMethod": "naptr"
},
"serviceMetadata": {
"status": "success",
"queryTimeMs": 245.67,
"endpoints": [
{
"status": "success",
"url": "https://ap.e-invoice.be/as4",
"documentTypes": [
{
"scheme": "busdox-docid-qns",
"value": "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"
}
],
"processes": [
{
"processId": {
"scheme": "cenbii-procid-ubl",
"value": "urn:fdc:peppol.eu:2017:poacc:billing:01:1.0"
},
"endpoints": [
{
"transportProfile": "peppol-transport-as4-v2_0",
"address": "https://ap.e-invoice.be/as4",
"serviceActivationDate": "2022-01-01T00:00:00Z",
"serviceExpirationDate": "2025-01-01T00:00:00Z",
"serviceDescription": "Company XYZ's AP service",
"technicalContactUrl": "https://support.e-invoice.be",
"technicalInformationUrl": "https://api.e-invoice.be",
"certificate": {
"status": "success",
"details": {},
"error": "Certificate expired"
}
}
]
}
],
"error": "Connection timeout"
}
],
"error": "Service unavailable"
},
"businessCard": {
"status": "success",
"entities": [
{
"name": "Example Corporation Ltd",
"countryCode": "NO",
"registrationDate": "2021-06-15T00:00:00Z",
"additionalInformation": [
"VAT: BE1018265814",
"Organization number: 1018.265.814"
]
}
],
"queryTimeMs": 123.45,
"error": "Business card not found"
},
"certificates": [
{
"status": "success",
"details": {},
"error": "Certificate expired"
}
],
"executionTimeMs": 895.32
}{
"detail": "<string>"
}{
"detail": "<string>"
}Query Parameters
Peppol ID in the format <scheme>:<id>. Example: 0208:1018265814 for a Belgian company.
Response
Successful Response
Response from a Peppol ID lookup operation.
This model represents the complete result of validating and looking up a Peppol ID in the Peppol network, including DNS information, service metadata, business card details, and certificate information.
Example: A successful lookup for a Peppol ID "0192:991825827" would return DNS information, service metadata with supported document types and processes, business card information with organization details, and certificate data.
Metadata about the query that was performed
Show child attributes
Show child attributes
Overall status of the lookup: 'success' or 'error'
"success"
List of error messages if any errors occurred during the lookup
[
"DNS lookup failed",
"Business card not available"
]
Information about the DNS lookup performed
Show child attributes
Show child attributes
Service metadata information for the Peppol participant
Show child attributes
Show child attributes
Business card information for the Peppol participant
Show child attributes
Show child attributes
List of certificates found for the Peppol participant
Show child attributes
Show child attributes
Total execution time of the lookup operation in milliseconds
895.32