Obtener departamento por su nombre

Busca departamentos por nombre o código SIFEN. Permite búsquedas flexibles con múltiples palabras.

---

Entorno

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

Endpoint

GET /departamentos/search?q={term}

Ejemplo de solicitud

curl -X GET "https://api.guarani.app/departamentos/search?q={term}" \
-H "x-api-key: Bearer <access_token>" \
-H "Accept: application/json" | jq

Nota: Asegúrate de reemplazar {term} por el término de búsqueda (nombre del departamento) y <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 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
q	string	Sí	Término de búsqueda (nombre del departamento). Ver departamentos

Búsquedas flexibles

• La búsqueda no distingue entre mayúsculas y minúsculas
• Soporta búsquedas parciales (ej: “cent” encontrará “CENTRAL”)
• Busca en: nombre de departamento y código SIFEN

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": "40b24d7a-28b1-4fee-87da-a10e01bd8bfc",
      "codigo_sifen": 1,
      "nombre": "CAPITAL"
    }
  ]
}

Recursos adicionales

Para obtener más información sobre posibles errores relacionados con los departamentos y cómo manejarlos, consulta la sección de errores.