Get user details v2

GET

/v2/users/{User-ID}

The endpoint returns the user's details based on their user ID. The response includes information about the user's status (such as active or verified), pending acceptance of terms & conditions, and more.

For Partners, using Bitpanda Enterprise "Bring Your Own License" solution, this endpoint is restricted.

User Journey context (optional)

The list of terms returned is filtered to those that apply to the resolved journeys.
You can supply the journey context in one of two mutually exclusive ways:

Option A — explicit user journey list:

Pass one or more user_journey values via user_journey[].

Option B — trading context (preferred):

Pass user_flow together with (when user_flow=trade) asset_group and asset_action. The API resolves the correct journeys internally.

Note: When no journey params are provided at all, the API falls back to the default configured journeys.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Query Params

Header Params

Responses

🟢200

application/json

Get user details V2

Bodyapplication/json

🟠400

🟠401

🟠404

🟠422

🔴503

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff '/v2/users/?user_journey[]=undefined&user_flow=undefined&asset_group=undefined&asset_action=undefined' \
--header 'Accept-Language;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "data": {
        "id": "2e4c89ac-1290-426f-8de0-4c7b40b91d3a",
        "account_level_id": 1,
        "type": "retail",
        "verified": true,
        "active": true,
        "buy_active": true,
        "trading_active": true,
        "trading": {
            "active": true,
            "reason_code": "TRADING_ACTIVE",
            "reason": "Trading active"
        },
        "registered_at": "2025-01-01T12:00:00+00:00",
        "appropriateness_tag": {
            "short_name": "appropriateness.not_appropriate",
            "requires_test_completion": false,
            "requires_test_resubmission": false
        },
        "terms_not_accepted": [
            1008,
            1012
        ],
        "is_pep": false,
        "offboarded": false,
        "tax_compliant": true,
        "external_id": "example-external-id-123"
    }
}

Modified at 2026-04-17 02:40:49

Search for users

Update an existing user

Get user details v2

User Journey context (optional)#

Request

Responses

User Journey context (optional)