Obtener una lista de las actividades economicas

Lista todas las actividades económicas registradas en el sistema de forma paginada. Permite consultar las actividades disponibles.

---

Entorno

URL Base: https://api.guarani.app

Endpoint

GET /actividades-economicas?page=1&limit=100

Ejemplo de solicitud

curl -X GET "https://api.guarani.app/actividades-economicas?page=1&limit=100" \
-H "x-api-key: Bearer <access_token>" \
-H "Accept: application/json" | jq

Nota: Asegúrate de reemplazar <access_token> con un token JWT válido proporcionado por el equipo Guarani.
Importante:
Es imprescindible incluir un token de acceso válido en el encabezado de la solicitud x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

---

Parámetros de consulta

Parámetro	Tipo	Requerido	Descripción
page	integer	No	Número de página. Por defecto: 1.
limit	integer	No	Resultados por página. Por defecto: 10

Encabezados de la solicitud

Encabezado	Valor	Descripción
x-api-key	Bearer <access_token>	Token de autenticación necesario para acceder al recurso.
Accept	application/json	Indica que la respuesta debe devolverse en formato JSON.

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Operación realizada correctamente.",
  "data": [
    {
      "id": "6b91b3a0-0894-45bc-a130-2b58b8eb8e93",
      "codigo": "C4_47110",
      "nombre": "Comercio al por menor en comercios no especializados con surtido compuesto principalmente por alimentos, bebidas o tabaco",
      "es_principal": true
    }
  ],
  "pagination": {
    "total_registros": 1,
    "pagina": 1,
    "total_paginas": 1
  }
}

Descripción de campos de respuesta

Campos principales

Campo	Tipo	Descripción
id	uuid	Identificador único de la actividad económica.
codigo	string	Código de la actividad económica según el catálogo SIFEN.
nombre	string	Descripción de la actividad económica.
es_principal	boolean	Indica si la actividad es principal (true) o secundaria (false).

Campos de paginación

Campo	Tipo	Descripción
total_registros	number	Cantidad total de actividades económicas en el sistema.
pagina	number	Número de página actual.
total_paginas	number	Cantidad total de páginas disponibles.

Recursos adicionales

Para más información sobre posibles errores y cómo manejarlos, consulta errores.