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"
}

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

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)

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

1	{
2	"user": {
3	"state": "ACTIVE",
4	"universal_identifier": "john@example.com",
5	"email_addr": "john@example.com",
6	"first_name": "John",
7	"last_name": "Doe",
8	"full_name": "John Doe",
9	"work_status": "FULL_TIME",
10	"employment_info": {
11	"employee_start_date_ts": "2023-05-14T09:30:00Z",
12	"role": "Software Engineer",
13	"manager_email": "emilysmith@example.com",
14	"cost_center_id": "A123",
15	"cost_center_name": "Engineering Department",
16	"department": "Engineering",
17	"office_phone_number": "555-123-4567",
18	"assistant_full_name": "Sarah Johnson",
19	"employment_location": {
20	"location": "Austin, Texas",
21	"office": "MTV",
22	"country_code": "1",
23	"region": "South Central",
24	"timezone": "Central Standard Time (CST)"
25	}
26	}
27	},
28	"system_identity": {
29	"id": "1234-5678-9012-3456",
30	"username": "JohnDoe"
31	},
32	"last_updated_at": "2023-05-14T09:30:00Z"
33	}