Employee Department entity

Read employee department groups with nested employees for dealership team pages and assignments.

#Endpoints

Employee departments group employees for team organization. Responses include nested employee summaries.

GET/v1/employee-departments

GET/v1/employee-departments/{id}

Auth

Send the dealership API key in the x-api-key header.

Detail IDs

Detail routes use the UUID returned by the corresponding list endpoint.

Dates

Date fields and date filters use ISO 8601 timestamps.

List endpoints share the same pagination envelope. Query booleans use true or false.

Parameter	Type	Required	Notes
limit	number	No	Number of records to return. Defaults to `100`. Maximum is `500`.
offset	number	No	Number of records to skip. Defaults to `0`.
search	string	No	Optional text search. Searchable fields are listed on each entity.
createdAfter	datetime	No	Return records created at or after an ISO 8601 timestamp.
createdBefore	datetime	No	Return records created at or before an ISO 8601 timestamp.
updatedAfter	datetime	No	Return records updated at or after an ISO 8601 timestamp.
updatedBefore	datetime	No	Return records updated at or before an ISO 8601 timestamp.

Entity filters

Common list filters plus search.

Search fields

name

Default sort

sortIndex ascending, then id ascending.

JSON

{
  "data": [],
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 0
  }
}

Field	Type	Nullable	Notes
id	uuid	No	Employee department ID.
name	string	No	Department name.
sortIndex	number	No	Display order.
employees	EmployeeSummary[]	No	Employees in this department.
createdAt	datetime	No	Creation timestamp.
updatedAt	datetime	No	Last update timestamp.

Fields

Includes id, name, sortIndex, nested employee summaries, createdAt, and updatedAt.

Shell

curl "https://api.driverseat.io/v1/employee-departments" \
  -H "x-api-key: sk-driverseat-..."

400

Invalid query parameter or resource ID. Common causes include a limit above 500, an invalid UUID, an invalid datetime, or an unsupported enum value.

401

The API key is missing, invalid, or revoked.

404

The requested employee department does not exist or does not belong to the dealership authorized by the API key.