Skip to main content
GET
/
departments
/
{id}
curl -X GET https://api.companyflow.com/departments/{id} \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "company_id": "987fcdeb-51a2-43f7-9c5d-123456789abc",
    "name": "Engineering",
    "code": "ENG",
    "description": "Software engineering and development",
    "parent_department_id": null,
    "cost_center": "CC-100",
    "status": "active",
    "created_at": "2026-03-03T10:00:00Z",
    "updated_at": "2026-03-03T10:00:00Z"
  }
}

Authentication

This endpoint requires authentication with a Bearer token. Only users with Super Admin or HR Manager roles can retrieve department details.
id
string
required
The unique identifier of the department

Response

success
boolean
Indicates if the request was successful
data
object
The department object
curl -X GET https://api.companyflow.com/departments/{id} \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "success": true,
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "company_id": "987fcdeb-51a2-43f7-9c5d-123456789abc",
    "name": "Engineering",
    "code": "ENG",
    "description": "Software engineering and development",
    "parent_department_id": null,
    "cost_center": "CC-100",
    "status": "active",
    "created_at": "2026-03-03T10:00:00Z",
    "updated_at": "2026-03-03T10:00:00Z"
  }
}

Build docs developers (and LLMs) love