Get user

GET

/v1/users/{userId}

Retrieve user information by user ID with optional field selection.

Security Requirements:

Bearer token authentication required

Only application members can access this endpoint

User must have APPLICATION_MEMBER permission

User can only get their own information unless using community-based access

Request

Path Params

Query Params

Responses

🟢200OK

application/json

Get user successful

Body

🟠400Bad Request

🟠401Unauthorized

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.returning.ai/v1/users/?_id&id&avatar&displayName&username&firstName&lastName&email&isOnline&lastLogin'

Response Example

200 - Success

{
    "meta": {
        "status": "success",
        "statusCode": 200
    },
    "message": "Get user success.",
    "data": {
        "_id": "61100af5c548eb5c7ebc7819",
        "id": 123456789,
        "avatar": "https://returning-ai.com/avatar.png",
        "displayName": "Admin",
        "username": "admin",
        "firstName": "John",
        "lastName": "Doe",
        "email": "admin@example.com",
        "isOnline": true,
        "lastLogin": "2023-12-01T10:30:00Z"
    }
}

Modified at 2026-04-07 08:26:05

Get Users with Filters