Get onboarding status by organization number

GET

/onboarding/status

Code sample: Shell / cURL

curl --request GET \
  --url 'https://welcome.ztlpay.io/onboarding/status?country=NO&organizationNumber=example' \
  --header 'Authorization: Bearer <token>'

• Production environment
• Sandbox environment for testing

Returns the onboarding status based on country and organization number. If no onboarding exists but the company already exists, the response returns Accepted.

Authorizations

• OAuth2Sandbox
  api://ac0d1aea-5e3a-463f-9dd1-194898ee5820/.default
• OAuth2Production
  api://1f115cad-5576-4db9-a7f9-8921c47a86e4/.default

Parameters

Query Parameters

country

required

string

Allowed values: NO SE DK

organizationNumber

required

string

Responses

200

Onboarding status fetched successfully

Media typeapplication/json

object

status

required

In production, ManualHandling is only available for Norway.

string

Allowed values: Created AwaitingCustomerAction Processing ManualHandling Accepted Rejected

signingStatus

object

onboardingSigningStatus

required

string

Allowed values: Signed PartiallySigned Unsigned

signers

Array<object>

object

name

required

string

personalNumber

string

nullable

status

required

string

Allowed values: Signed Unsigned

signingUrl

string

nullable

documentSignature

object

signatureMethod

string

nullable

fullName

string

nullable

firstName

string

nullable

lastName

string

nullable

middleName

string

nullable

signedTime

string

nullable

dateOfBirth

string

nullable

Examples

Company exists without onboarding

{
  "status": "Accepted"
}

Existing onboarding with unsigned signers

{
  "status": "AwaitingCustomerAction",
  "signingStatus": {
    "onboardingSigningStatus": "Unsigned",
    "signers": [
      {
        "name": "John Doe",
        "personalNumber": "01019012345",
        "status": "Unsigned",
        "signingUrl": "https://www.google.com",
        "documentSignature": null
      }
    ]
  }
}

Headers

ztl-request-id

string format: uuid

Unique RequestId, please provide this Id in case of support requests

Example

3a797348-ef0c-4f52-b821-fdfcdb98c4d9

400

Bad request

Media typeapplication/json

object

ztlRequestId

required

Unique RequestId, please provide this Id in case of support requests

string format: uuid

message

required

The underlying reason for the error

string

Example

{
  "ztlRequestId": "3a797348-ef0c-4f52-b821-fdfcdb98c4d9",
  "message": "Invalid account"
}

Headers

ztl-request-id

string format: uuid

Unique RequestId, please provide this Id in case of support requests

Example

3a797348-ef0c-4f52-b821-fdfcdb98c4d9

403

Forbidden

Media typeapplication/json

object

ztlRequestId

required

Unique RequestId, please provide this Id in case of support requests

string format: uuid

message

required

The underlying reason for the error

string

Example

{
  "ztlRequestId": "3a797348-ef0c-4f52-b821-fdfcdb98c4d9",
  "message": "Invalid account"
}

Headers

ztl-request-id

string format: uuid

Unique RequestId, please provide this Id in case of support requests

Example

3a797348-ef0c-4f52-b821-fdfcdb98c4d9

404

Not found

500

Internal server error

Media typeapplication/json

object

ztlRequestId

required

Unique RequestId, please provide this Id in case of support requests

string format: uuid

message

required

The underlying reason for the error

string

Example

{
  "ztlRequestId": "3a797348-ef0c-4f52-b821-fdfcdb98c4d9",
  "message": "Invalid account"
}

Headers

ztl-request-id

string format: uuid

Unique RequestId, please provide this Id in case of support requests

Example

3a797348-ef0c-4f52-b821-fdfcdb98c4d9

503

Service unavailable

Media typeapplication/json

object

ztlRequestId

required

Unique RequestId, please provide this Id in case of support requests

string format: uuid

message

required

The underlying reason for the error

string

Example

{
  "ztlRequestId": "3a797348-ef0c-4f52-b821-fdfcdb98c4d9",
  "message": "Invalid account"
}

Headers

ztl-request-id

string format: uuid

Unique RequestId, please provide this Id in case of support requests

Example

3a797348-ef0c-4f52-b821-fdfcdb98c4d9