# Client onboarding

Submit a client and wait for it to become active.

Product: PNSL API
Guides follow API reference 2.0.0 and event reference 1.0.0.
Canonical page: https://docs.axiym.io/pnsl-api/integration-guide/implementation-guides/client-onboarding

Onboarding submits a client for compliance (KYB) and financial underwriting.
Underwriting sets the client's credit limit.

## 1. Submit the client

Call [`POST /onboardings`](/pnsl-api/api-reference/2.0.0/onboarding/startOnboarding)
with the client's legal details, currency, payment rail, and the bank account
that will receive disbursements. You can include your own client reference as
`partnerClientId`.

The response contains the `clientId`; store it with your client reference.
The case starts in `ONBOARDING`. Axiym collects the KYB documents through its
compliance process.

## 2. Wait for the decision

Poll [`GET /onboardings/{clientId}`](/pnsl-api/api-reference/2.0.0/onboarding/getOnboardingStatus)
while the status is `ONBOARDING`.

* `APPROVED`: the client becomes `ACTIVE` and `client.activated` is sent.
* `REJECTED`: the client cannot be funded. No event is sent.

Do not submit the client again while the review is in progress.

## 3. Use the client

Once `GET /clients/{clientId}` returns status `ACTIVE`, continue with
[Check financing capacity](/pnsl-api/integration-guide/implementation-guides/check-credit-capacity).