# Listar autorizaciones de acceso del soporte

`GET /v1/support-access-grants` · permiso `support-access-grants:read`

Lista los accesos con límite de tiempo que este entorno ha concedido al personal de soporte de KeenAuth, del más reciente al más antiguo. Solo se admite la paginación hacia delante (`after`); `before` y cualquier `order` distinto de `desc` devuelven `422`. `status` devuelve solo las autorizaciones en ese estado; `expired` significa no revocada y con `expires_at` vencido.

## Solicitud

| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| `limit` | integer | no | Tamaño de página, 1-100 (20 por defecto). |
| `after` | string | no | Cursor `list_metadata.after` de la página anterior. |
| `status` | string | no | Solo las autorizaciones en este estado: `active`, `revoked` o `expired`. |

Sin cuerpo de solicitud.

## Respuesta

`200 OK` con una página de autorizaciones.

```json
{
  "data": [
    {
      "id": "sag_01j9xk3m7q8r2s4t6v8w0y2z4a",
      "scope": "read",
      "status": "active",
      "ticket_ref": "SUP-48213",
      "allowed_regions_of_staff": ["eu"],
      "granted_by": "du_01j9xk2p5n7q9s1t3v5w7y9z1b",
      "created_at": "2026-10-12T09:30:00.123456Z",
      "expires_at": "2026-10-13T09:30:00.123456Z",
      "revoked_at": null
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}
```

## Errores

| HTTP | código | Cuándo |
|---|---|---|
| 400 | `invalid_cursor` | El cursor no es válido o pertenece a otro filtro. |
| 422 | `validation_failed` | Un parámetro de consulta no es válido (`before`, `order=asc`, `status` desconocido). |
| 403 | `insufficient_permissions` | La credencial no tiene el permiso requerido. |
| 401 | `unauthenticated` | La credencial falta, no es válida o fue revocada. |
| 429 | `rate_limited` | Se superó el límite de frecuencia; reintente después del periodo `Retry-After`. |
| 503 | `service_unavailable` | Una dependencia no está disponible temporalmente; reintente después del periodo `Retry-After`. |

## Ejemplo

```bash
curl "https://api.eu.keenauth.com/v1/support-access-grants?status=active&limit=20" \
  -H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
```