Peppol registration

Register company on Peppol

Property	Value
Endpoint	/peppol/register-request
Method	GET
Authorization	Bearer {token}

Query parameters

Parameter	Type	Required	Description
companyId	UUID	Yes	Company to register
icd	String	Yes	Peppol identifier scheme (e.g. 0088 GLN, 9930 DE VAT, 0009 FR SIRET)
specialIdentifier	String	No	Custom identifier value
businessIdentifier	String	No	Business identifier (VAT, GLN, etc.)
isNewParticipant	Boolean	Yes	true = new registration, false = update existing

Common ICD codes — France / Germany

Country	ICD code	Type
Germany	9930	VAT number
Germany	0088	GLN
France	0009	SIRET
France	0002	SIREN

Responses

Code	Description
200	Registration request created
409	Participant already registered

Get registration status

Property	Value
Endpoint	/peppol/get-register-request-status
Method	GET
Authorization	Bearer {token}

Query parameters: companyId (UUID)

Check participant exists

Property	Value
Endpoint	/peppol/check-participant
Method	GET
Authorization	Bearer {token}

Query parameters: participantId — Peppol participant ID (e.g. 0009:12345678901234)

Use this before sending an invoice to verify the recipient is on the Peppol network.

Get supported identifiers by country

Property	Value
Endpoint	/peppol/get-identifiers-by-country
Method	GET
Authorization	Bearer {token}

Query parameters: countryCode — ISO 3166-1 alpha-2 (FR, DE)

Delete Peppol registration

Property	Value
Endpoint	/peppol/delete-request
Method	GET
Authorization	Bearer {token}

Parameter	Type	Required	Description
companyId	UUID	Yes	Company ID
registerRequestId	UUID	Yes	Registration request to cancel
deleteReason	String	No	Reason for deletion

Lookup Peppol business card

Property	Value
Endpoint	/peppol/lookup-business-card
Method	GET
Authorization	Bearer {token}

Query parameters: participantId

Get / update Peppol settings

Property	Value
GET	/peppol/settings/:companyId
PUT	/peppol/settings/:companyId
Authorization	Bearer {token}