Notifications

Lister les notifications envoyées (ou à envoyer) sur vos canaux

GET/v1/notifications

Du plus récent au plus ancien. L’historique des canaux et des règles supprimés reste listé.

Authentification: Clé d’API (Authorization: Bearer)
Portée requise: read

Liste paginée par curseur : voir Pagination.

Paramètres de requête#

channel_idstring · uuid
rule_idstring · uuid
statusstring
Valeurs queued sending sent failed grouped
sincestring
Date ou date-heure ISO 8601, incluse (par exemple 2026-11-01T00:00:00Z).
untilstring
Date ou date-heure ISO 8601, exclue.
limitinteger
Par défaut 50
de 1 à 100
cursorstring
next_cursor de la page précédente, tel quel.

Réponses#

200Une page de notifications, de la plus récente à la plus ancienne.

Champs de l’objet

datatableau de objectobligatoire
Champs de chaque élément
- idstring · uuid
- channel_idstring · uuid
- channel_kindstring
  Valeurs webhook discord slack email telegram hellome
- kindstring
  alert, digest, test, security, summary, service.
- stagestring
  Étape de l’alerte : unconfirmed (vue avant les confirmations), confirmed, cancelled (retirée par une réorganisation de la chaîne), escalation ; ou type du message pour les notifications qui ne sont pas des alertes.
  
  Valeurs unconfirmed confirmed cancelled escalation digest test security summary service
- statusstring
  Valeurs queued sending sent failed grouped
- priorityinteger
- rule_idstring · uuidpeut valoir null
- match_idstring · uuidpeut valoir null
- digest_idstring · uuidpeut valoir null
  Récapitulatif qui a compté cette alerte regroupée.
- attemptsinteger
- next_attempt_atstring · date-timepeut valoir null
- sent_atstring · date-timepeut valoir null
- failed_atstring · date-timepeut valoir null
- last_errorstringpeut valoir null
- titlestring
  Première ligne du message.
- textstring
- created_atstring · date-time
has_morebooleanobligatoire
next_cursorstringobligatoirepeut valoir null

4xx · 5xxErreur.

Erreur au format standard : voir Erreurs.

Requête

cURL

curl "https://aicscan.io/v1/notifications?status=failed&limit=20" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/notifications?status=failed&limit=20', {
  headers: {
    Authorization: `Bearer ${process.env.AICSCAN_API_KEY}`,
  },
});
const data = await res.json();
if (!res.ok) throw new Error(data.error.code);
console.log(data);

Python

import os
import requests

resp = requests.get(
    "https://aicscan.io/v1/notifications?status=failed&limit=20",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Réponse 200

JSON

{
  "data": [
    {
      "id": "0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
      "channel_id": "0193a1b3-7d21-7c55-8e0a-9f1b2c3d4e5f",
      "channel_kind": "webhook",
      "kind": "alert",
      "stage": "confirmed",
      "status": "sent",
      "priority": 30,
      "rule_id": "0193a1b4-2e7f-7a10-9b3c-4d5e6f708192",
      "match_id": "0193a1c9-3f10-7d42-8a1b-2c3d4e5f6a7b",
      "digest_id": null,
      "attempts": 1,
      "next_attempt_at": null,
      "sent_at": "2026-11-14T09:30:14.020Z",
      "failed_at": null,
      "last_error": null,
      "title": "🔴 CRITICAL · Treasury: large USDT outflows · outgoing",
      "text": "🔴 CRITICAL · Treasury: large USDT outflows · outgoing\n✅ Confirmed · 15 confirmations\nChain: BNB Chain\nAddress: Treasury (0x8894…d4e3)\nAmount: 250,000 USDT (≈ $250,000)\nTo: 0x77cd…01e2 (unknown)\nBlock 45,123,456\nDetails: https://aicscan.io/e/0193a1c9-3e02-7f3a-9b4c-5d6e7f8091a2",
      "created_at": "2026-11-14T09:30:13.611Z"
    }
  ],
  "has_more": true,
  "next_cursor": "0193a1b25c3d7e4f8a9b0c1d2e3f4a5b"
}