Skip to main content
Version: 1.0.0

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-stage.docnova.ai/
Production Environment https://api.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": "9930",
"businessIdentifier": "1234567890123"
}'

Request body

{
"companyApiKey": "<company-apiKey>",
"icd": "9930",
"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 RequestThe 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.