> ## 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 Alerta por Id

> Recupera una alerta específica por su identificador

## Descripción

Este endpoint devuelve información detallada sobre una alerta específica identificada por su ID único. La respuesta incluye todos los detalles de la alerta, incluyendo severidad, estado, campos personalizados y observables asociados.

## Parámetros de Ruta

<ParamField path="id" type="string" required>
  El identificador único de la alerta
</ParamField>

## Respuesta

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

<ResponseField name="data" type="object">
  Objeto con los detalles de la alerta
</ResponseField>

<ResponseField name="data.id" type="string">
  Identificador único de la alerta
</ResponseField>

<ResponseField name="data.title" type="string">
  Título de la alerta
</ResponseField>

<ResponseField name="data.description" type="string">
  Descripción detallada de la alerta
</ResponseField>

<ResponseField name="data.severity" type="string">
  Nivel de severidad (low, medium, high, critical)
</ResponseField>

<ResponseField name="data.status" type="string">
  Estado actual de la alerta
</ResponseField>

<ResponseField name="data.source" type="string">
  Fuente de la alerta
</ResponseField>

<ResponseField name="data.created_at" type="string" format="date-time">
  Fecha y hora de creación
</ResponseField>

<ResponseField name="data.updated_at" type="string" format="date-time">
  Fecha y hora de última actualización
</ResponseField>

<ResponseField name="data.assigned_to" type="string | null">
  Usuario asignado a la alerta (o null si no está asignada)
</ResponseField>

<ResponseField name="data.tags" type="array">
  Lista de etiquetas asociadas a la alerta
</ResponseField>

<ResponseField name="data.observables" type="array">
  Lista de observables asociados a la alerta
</ResponseField>

<ResponseField name="data.custom_fields" type="object">
  Campos personalizados definidos para la alerta
</ResponseField>

## Ejemplo de Solicitud

```bash theme={null}
curl -X GET "https://api.casebender.com/v1/alerts/alert-123" \
  -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": "ana.garcia@empresa.com",
    "tags": ["suspicious", "login"],
    "observables": [
      {
        "type": "ip",
        "value": "192.168.1.1"
      },
      {
        "type": "user",
        "value": "john.doe@example.com"
      }
    ],
    "custom_fields": {
      "impacto_estimado": "Medio",
      "sistema_afectado": "Sistema de Autenticación",
      "requiere_escalamiento": false
    }
  }
}
```

## 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 404 -
  Not Found - Alerta no encontrada 500 - Internal Server Error - Error del
  servidor
</ResponseExample>

## Notas

* Para obtener una lista de todas las alertas, utilice el endpoint [Obtener Alertas](/es/api-reference/endpoint/alert/get)
* Para actualizar una alerta, utilice el endpoint [Actualizar Alerta](/es/api-reference/endpoint/alert/update)