AWorld APIs are in a pre-alpha stage and are being updated frequently. For integration inquiries or technical information, please contact us at server@aworld.org.

Get current user principal

GET

https://api.eu-west-1.aworld.cloud/app/v1/users/me/principal

Retrieves the principal information for the currently authenticated user.
Principal contains the user's identity details.

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Responses

🟢200OK

application/json

User principal retrieved successfully

Body

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.eu-west-1.aworld.cloud/app/v1/users/me/principal' \
--header 'Authorization: Bearer <token>'

Response Example

{
    "principalId": "string",
    "sub": "string",
    "email": "user@example.com",
    "firstName": "string",
    "lastName": "string"
}

Modified at 2025-10-14 14:40:02

Get current user

List virtual balances