Start hosted KYB

Production

POST

/v1/brl/kyb/new-level-1/web-sdk

Starts or resumes the provider's hosted KYB level-1 flow for an owned company subaccount.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Header Params

🟢200

application/json

Hosted KYB attempt and step URLs returned.

Bodyapplication/json

🟠400

🟠404

🟠409

🔴500

🔴502

🟠401ManagedSelectorUnauthorized

🟠403BrlaManagedSelectorForbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST '/v1/brl/kyb/new-level-1/web-sdk?subAccountId=' \
--header 'X-Managed-Profile-Id;' \
--header 'X-API-Key: <api-key>'

Response Example

200 - Example 1

{
    "attemptId": "string",
    "authorizedRepresentativeUrl": "http://example.com",
    "basicCompanyDataUrl": "http://example.com"
}

Modified at 2026-08-19 18:12:56