Get Employee

Retrieve detailed information about a specific employee.

GET

/api/v1/employees/{id}

Description

Returns employee profile and location data. ID may be numeric or an encoded ID from list employees. Use include_assets=true to embed assigned 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	Employee record ID (numeric or base64-encoded encrypted ID).

Query Parameters

Parameter	Type	Required	Description
include_assets	boolean	No	Set to true or 1 to include AssignedAssets array.

Response

Related Endpoints

List Employees

List all employees

Create Employee

Add a new employee

Did this page help you?

Request

curl -X GET https://uat.unduit.com/api-exposed/api/v1/employees/123?include_assets=true \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json"

Success Response

{
  "success": true,
  "employee": {
    "id": 123,
    "encoded_id": "YWJjMTIz...",
    "FirstName": "John",
    "LastName": "Doe",
    "LocationName": "San Francisco Remote Hub",
    "PhoneCountryCode": "US",
    "ContactInfo": "4155550198",
    "Email": "john.doe@example.com",
    "Country": "US",
    "State": "CA",
    "City": "San Francisco",
    "Zip": "94103",
    "LocationType": "Remote Employee",
    "Address_1": "123 Market Street",
    "Address_2": "Suite 400",
    "AssignedAssets": [
      {
        "assetId": "AST-1001",
        "serialNumber": "C02XK1ABCDEF",
        "modelName": "MacBook Pro 14",
        "productType": "Laptop",
        "assetStatus": "In Use"
      }
    ]
  }
}

Error Responses

404 Not Found

{
  "success": false,
  "message": "Employee not found"
}

422 Invalid ID

{
  "success": false,
  "message": "Invalid employee id",
  "errors": { "id": "A valid employee id is required." }
}