Skip to main content
Version: 1.0.1

Submit register request


Register a company on the Peppol network using its business identifier.

Endpoint​

PropertyValue
URLPOST /white-label-partner/register-request
MethodPOST
AuthR-Auth: <partner-jwt>
Content-Typeapplication/json
Base URLStage Environment https://api-fr-stage.docnova.ai/
Production Environment https://api-fr.docnova.ai/

Example Request​

curl --location '{{baseUrl}}/white-label-partner/register-request' \
--header 'Content-Type: application/json' \
--header 'R-Auth: {{partnerJwt}}' \
--data-raw '{
"companyApiKey": "{{companyApiKey}}",
"icd": "0225",
"businessIdentifier": "1234567890123"
}'

Request body​

{
"companyApiKey": "<company-apiKey>",
"icd": "0225",
"businessIdentifier": "1234567890123"
}

Request fields​

FieldTypeRequiredDescription
companyApiKeystringYesCompany API key from Create company or Get company API key
icdstringYesPeppol ICD scheme code
businessIdentifierstringYesThe identifier value under the given ICD

Common ICD codes​

ICDSchemeCountry
0225SIRENFrance
9930VATGermany
0088GLNGlobal
0184CVRDenmark
9914VATAustria
0208CBEBelgium

Response​

{
"companyId": "f5e6d7c8-1234-5678-9abc-...",
"status": "APPROVED"
}

Response fields​

FieldDescription
companyIdCompany UUID
statusAPPROVED for auto-approved requests or IN_PROCESS for requests pending review
Auto-approval

participantAutoApprove is enabled for your partner account. All Peppol registrations return APPROVED immediately without manual review.

Error Codes​

HTTP StatuserrorTypeDescription
400 Bad Request—The companyApiKey is invalid, inactive, or expired. Check the errorMessage field in the response for details.
403 ForbiddenPARTNER_ACCESS_DENIEDThe company associated with companyApiKey does not belong to this partner account.
404 Not FoundCOMPANY_NOT_FOUNDNo active company was found for the provided companyApiKey.