Referencia de la APIDepartamentos
Listar
Descripcion general
Este endpoint permite obtener un listado paginado de los departamentos pertenecientes a tu organización. Los resultados se devuelven en formato JSON e incluyen metadatos de paginación. Cada departamento incluye su jerarquía mediante los campos parent_id y depth, y su vínculo con un centro de costos mediante cost_center_id. Los departamentos eliminados se excluyen automáticamente.
Endpoint
GET
https://app.integranom.com/api/v1/departmentsConsulta multiples departamentos
Query params
| Parametro | Tipo | Requerido | Default | Descripcion |
|---|---|---|---|---|
page | integer ≥ 1 | No | 1 | Página solicitada. El tamaño de página es fijo en 20. |
active | "true" | "false" | No | - | Filtra por el flag is_active. |
Consulta un departamento especifico
Se puede buscar un departamento particular por su número, nombre o código. Los tres filtros hacen coincidencia exacta sin distinguir mayúsculas y minúsculas: el nombre y el código se almacenan en mayúsculas y el filtro se compara también en mayúsculas.
Query params
| Parametro | Tipo | Requerido | Default | Descripcion |
|---|---|---|---|---|
department_number | integer | No | - | Filtra por número de departamento exacto. |
name | string | No | - | Filtra por nombre exacto. |
code | string | No | - | Filtra por código exacto (almacenado en mayúsculas). |
Errores
| Status | Causa |
|---|---|
400 | Valor inválido en department_number o active. |
401 | API key ausente o inválida. |
403 | La API key no tiene el permiso getDepartments. |