Skip to main content
Retrieve the complete profile for the currently authenticated user. This endpoint returns identity details, KYC status, and account standing, and is the primary way to hydrate user state on the client after sign-in. GET /v1/users/me Requires a Bearer token in the Authorization header.

​
Request

No query parameters or request body.

​
Example

curl --request GET \
  --url "https://api.nyotaimara.com/v1/users/me" \
  --header "Authorization: Bearer <token>"

​
Response

​
success
boolean
required
true when the profile was retrieved successfully.
​
data
object
required
The user profile object.
{
  "success": true,
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "email": "jane@example.com",
    "firstName": "Jane",
    "lastName": "Doe",
    "phone": "+254700000000",
    "dob": "1990-05-14",
    "avatarUrl": "https://cdn.nyotaimara.com/avatars/user-1714000000000-abc123.jpg",
    "status": "active",
    "kycStatus": "verified",
    "createdAt": "2024-01-15T08:30:00.000Z",
    "updatedAt": "2024-06-01T12:00:00.000Z"
  }
}
Error cases
StatusErrorDescription
401—Missing or invalid Bearer token.
404User profile not foundThe authenticated user has no profile record.
500Internal server errorAn unexpected server-side error occurred.