Get User By ID | Moveworks

curl http://localhost:5000/myinstance1/users/userId \
     -H "Authorization: Bearer <token>"

{
  "user": {
    "state": "ACTIVE",
    "universal_identifier": "john@example.com",
    "email_addr": "john@example.com",
    "first_name": "John",
    "last_name": "Doe",
    "full_name": "John Doe",
    "work_status": "FULL_TIME",
    "employment_info": {
      "employee_start_date_ts": "2023-05-14T09:30:00Z",
      "role": "Software Engineer",
      "manager_email": "emilysmith@example.com",
      "cost_center_id": "A123",
      "cost_center_name": "Engineering Department",
      "department": "Engineering",
      "office_phone_number": "555-123-4567",
      "assistant_full_name": "Sarah Johnson",
      "employment_location": {
        "location": "Austin, Texas",
        "office": "MTV",
        "country_code": "1",
        "region": "South Central",
        "timezone": "Central Standard Time (CST)"
      }
    }
  },
  "system_identity": {
    "id": "1234-5678-9012-3456",
    "username": "JohnDoe"
  },
  "last_updated_at": "2023-05-14T09:30:00Z"
}

Returns user details given their userId. We recommend a rate limit of 5 req/sec for this endpoint.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

userIdstringRequired

ID of user to fetch details for

Response headers

X-RateLimit-Limitinteger

The maximum number of requests you're permitted to make per minute.

X-RateLimit-Remaininginteger

The number of requests remaining in the current rate limit window.

X-RateLimit-Resetstring or null

The remaining window before the rate limit FULLY resets in UTC epoch seconds.

Response

A single user

userobject

system_identityobject

last_updated_atstringformat: "timestamp"

Represents the timestamp indicating the most recent modification or update made to the user’s information (in ISO-8601 UTC)