---
title: "Listar unidades de negocio"
method: GET
path: "/v1/unidades-negocio"
tags: ["Unidades de Negocio"]
---

# Listar unidades de negocio

`GET /v1/unidades-negocio`

## Request

- Base URL: `https://api.loggro.com/apik/loggro-organizacion`
- URL: `https://api.loggro.com/apik/loggro-organizacion/v1/unidades-negocio`
- Auth: HTTP bearer

Retorna el listado paginado de las unidades de negocio de la compañía. Los parámetros `page` y `limit` son opcionales; cuando no se envían se consulta la página 1 con un tamaño de página de 20 registros. El tamaño máximo de página permitido es de 100 registros.

## Query parameters

- `page` integer
- `limit` integer
- `offset` integer

## Response `200`

Listado de unidades de negocio obtenido exitosamente

- UnidadesNegocioRespuestaDTO
  - `contenido` UnidadNegocioDTO[]
    - `uuid` string: Identificación única de la unidad de negocio
    - `codigo` string: Código de la unidad de negocio
    - `nombre` string: Nombre de la unidad de negocio
    - `codigoCompleto` string: Código completo de la estructura organizacional hasta la unidad de negocio
    - `descripcion` string: Descripción de la unidad de negocio
    - `estado` 'ACT' | 'INA': Estado de la unidad de negocio
    - `padre` string, nullable: Identificación única (uuid) de la unidad de negocio padre. Nulo cuando la unidad de negocio no tiene padre.
  - `metadata` object
    - `pagination` object
      - `offset` integer: Registros omitidos
      - `limit` integer: Límite de registros por página
      - `total` integer: Total de registros disponibles

## Other responses

- `400`: El parámetro `limit` supera el máximo permitido (100)
- `401`: No autorizado para el uso del servicio. **Posibles causas:** - Token incorrecto o expirado.
- `500`: Error interno en el procesamiento del servicio

---

[API](https://skmtc.dev/loggro/apis/pymes-organizaci-n.md) - [All operations](https://skmtc.dev/loggro/apis/pymes-organizaci-n/llms.txt) - [OpenAPI document](https://skmtc.dev/loggro/apis/pymes-organizaci-n/revisions/53f0f688b60b?raw)