Skip to main content

​
Departments API

The Departments API provides endpoints to retrieve department information within the organization.

​
Endpoints

​
Get All Departments

Retrieves a list of all departments in the organization. 
curl -X GET "https://api.integra.com/departamentos" \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Request

Method: GET Endpoint: /departamentos Headers:
  • Authorization: Bearer token (required)

​
Response

Status Code: 200 OK
Response Example
{
  "data": [
    {
      "id": 1,
      "nombre": "Recursos Humanos"
    },
    {
      "id": 2,
      "nombre": "Tecnología"
    },
    {
      "id": 3,
      "nombre": "Ventas"
    }
  ],
  "message": "Departamentos"
}

​
Entity Structure

​
Department Entity

FieldTypeDescription
idIntegerUnique identifier for the department
nombreStringName of the department

​
Relationships

Departments are organizational units that:
  • Can be associated with employees
  • May contain multiple positions (puestos)
  • Part of the organizational hierarchy structure

Build docs developers (and LLMs) love

Get started for freeTalk to us