> ## Documentation Index
> Fetch the complete documentation index at: https://docs.casebender.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener Alertas

> Recupera una lista de alertas

## Descripción

Este endpoint devuelve una lista paginada de alertas. Puede filtrar las alertas por varios criterios como severidad, estado, fecha, etc.

## Parámetros de Consulta

<ParamField query="page" type="integer" default="1">
  Número de página para la paginación
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Número de resultados por página (máximo 100)
</ParamField>

<ParamField query="status" type="string">
  Filtrar por estado de alerta (open, closed, in\_progress)
</ParamField>

<ParamField query="severity" type="string">
  Filtrar por severidad (low, medium, high, critical)
</ParamField>

<ParamField query="from_date" type="string" format="date">
  Filtrar alertas creadas después de esta fecha (formato ISO 8601)
</ParamField>

<ParamField query="to_date" type="string" format="date">
  Filtrar alertas creadas antes de esta fecha (formato ISO 8601)
</ParamField>

<ParamField query="search" type="string">
  Término de búsqueda para filtrar alertas por título o descripción
</ParamField>

## Respuesta

<ResponseField name="status" type="string">
  Estado de la respuesta (success o error)
</ResponseField>

<ResponseField name="data" type="array">
  Lista de objetos de alerta
</ResponseField>

<ResponseField name="pagination" type="object">
  Información de paginación
</ResponseField>

<ResponseField name="pagination.total" type="integer">
  Número total de alertas que coinciden con los criterios de filtro
</ResponseField>

<ResponseField name="pagination.pages" type="integer">
  Número total de páginas
</ResponseField>

<ResponseField name="pagination.current_page" type="integer">
  Página actual
</ResponseField>

<ResponseField name="pagination.limit" type="integer">
  Número de resultados por página
</ResponseField>

## Ejemplo de Solicitud

```bash theme={null}
curl -X GET "https://api.casebender.com/v1/alerts?status=open&severity=high&limit=10" \
  -H "Authorization: Bearer su-token-jwt"
```

## Ejemplo de Respuesta

```json theme={null}
{
  "status": "success",
  "data": [
    {
      "id": "alert-123",
      "title": "Actividad sospechosa detectada",
      "description": "Se detectó un intento de inicio de sesión desde una ubicación inusual",
      "severity": "high",
      "status": "open",
      "source": "auth_service",
      "created_at": "2023-01-15T08:30:00Z",
      "updated_at": "2023-01-15T08:30:00Z",
      "assigned_to": null,
      "tags": ["suspicious", "login"],
      "observables": [
        {
          "type": "ip",
          "value": "192.168.1.1"
        },
        {
          "type": "user",
          "value": "john.doe@example.com"
        }
      ]
    }
    // ... más alertas
  ],
  "pagination": {
    "total": 45,
    "pages": 5,
    "current_page": 1,
    "limit": 10
  }
}
```

## Códigos de Estado

<ResponseExample>
  200 - OK - La solicitud se completó con éxito 400 - Bad Request - Parámetros
  de consulta inválidos 401 - Unauthorized - Token de autenticación faltante o
  inválido 403 - Forbidden - No tiene permiso para acceder a este recurso 429 -
  Too Many Requests - Se ha excedido el límite de tasa 500 - Internal Server
  Error - Error del servidor
</ResponseExample>

## Notas

* Las alertas se ordenan por fecha de creación en orden descendente (las más recientes primero)
* Para obtener todos los detalles de una alerta específica, utilice el endpoint [Obtener Alerta por ID](/es/api-reference/endpoint/alert/get-by-id)