Get Employee
Retrieve detailed information about a specific employee by ID.
GET
/api/v2/employees/{id}Description
Fetches detailed information about a single employee identified by their unique ID. Returns complete employee profile including contact information, department, job title, and other attributes.
This endpoint also supports the include query parameter (same as the List Employees endpoint) to expand related data such as assigned assets. Example: /api/v2/employees/emp_123?include=assets
Request
Headers
| Header | Value | Required |
|---|---|---|
| Authorization | Bearer <access_token> | Yes |
| Content-Type | application/json | Yes |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | Yes | The unique identifier of the employee |
Query Parameters (Optional)
| Parameter | Type | Required | Description |
|---|---|---|---|
| include | String | No | Comma-separated list of related data to include. Options: assets, manager, department. Example: assets,manager |
Response
Response Fields
| Field | Type | Description |
|---|---|---|
| success | boolean | Whether the request was successful |
| data | object | Employee object containing all profile information |
| data.id | string | Unique employee identifier |
| data.email | string | Employee's email address |
| data.firstName | string | Employee's first name |
| data.lastName | string | Employee's last name |
| data.department | string | Employee's department |
| data.jobTitle | string | Employee's job title |
| data.status | string | Employment status (active, inactive, on_leave) |
Error Responses
Common error responses you may encounter when using this endpoint.
Notes
- This endpoint requires valid authentication. Include your access token in the Authorization header.
- You can only retrieve employees within your organization or those you have explicit permission to view.
- The response includes all standard employee fields. Contact details may be restricted based on your role and permissions.
- Use the
includequery parameter to expand related data such as assigned assets. This works the same way as the List Employees endpoint. - For bulk operations or retrieving multiple employees, use the List Employees endpoint instead.
Related Endpoints
Did this page help you?
Request
curl -X GET https://api.unduit.com/v2/employees/emp_1234567890 \
-H "Authorization: Bearer <token>"Success Response (200)
{
"success": true,
"data": {
"id": "emp_1234567890",
"email": "jane.smith@company.com",
"firstName": "Jane",
"lastName": "Smith",
"department": "Engineering",
"jobTitle": "Senior Software Engineer",
"status": "active",
"phone": "+1 (555) 123-4567",
"startDate": "2020-03-15",
"manager": {
"id": "emp_0987654321",
"name": "John Doe"
},
"createdAt": "2020-03-15T10:30:00Z",
"updatedAt": "2024-03-13T14:22:00Z"
}
}404 Not Found
{
"success": false,
"error": {
"code": "EMPLOYEE_NOT_FOUND",
"message": "Employee with ID emp_1234567890 not found"
}
}401 Unauthorized
{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Missing or invalid authentication token"
}
}403 Forbidden
{
"success": false,
"error": {
"code": "FORBIDDEN",
"message": "You do not have permission to access this employee record"
}
}