Notifications

Get a notification and its delivery attempts

GET/v1/notifications/{id}

Authentication: API key (Authorization: Bearer)
Required scope: read

Path parameters#

idstring · uuidrequired

Responses#

200Notification.

Object fields

idstring · uuid
channel_idstring · uuid
channel_kindstring
Values webhook discord slack email telegram hellome
kindstring
alert, digest, test, security, summary, service.
stagestring
Step of the alert: unconfirmed (seen before confirmations), confirmed, cancelled (removed by a chain reorganization), escalation; or the kind of message for non-alert notifications.

Values unconfirmed confirmed cancelled escalation digest test security summary service
statusstring
Values queued sending sent failed grouped
priorityinteger
rule_idstring · uuidnullable
match_idstring · uuidnullable
digest_idstring · uuidnullable
Digest that counted this grouped alert.
attemptsinteger
next_attempt_atstring · date-timenullable
sent_atstring · date-timenullable
failed_atstring · date-timenullable
last_errorstringnullable
titlestring
First line of the message.
textstring
created_atstring · date-time
delivery_attemptsarray of object
Newest first, 100 at most.
Fields of each item
- attemptinteger
- okboolean
- status_codeintegernullable
- duration_msinteger
- errorstringnullable
- atstring · date-time

4xx · 5xxError.

Standard error format: see Errors.

Request

cURL

curl "https://aicscan.io/v1/notifications/0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d" \
  -H "Authorization: Bearer $AICSCAN_API_KEY"

JavaScript

const res = await fetch('https://aicscan.io/v1/notifications/0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d', {
  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/0193a1c9-41aa-7b2e-9c0d-1e2f3a4b5c6d",
    headers={
        "Authorization": f"Bearer {os.environ['AICSCAN_API_KEY']}",
    },
    timeout=10,
)
resp.raise_for_status()
print(resp.json())

Response 200

JSON

{
  "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",
  "delivery_attempts": [
    {
      "attempt": 1,
      "ok": true,
      "status_code": 200,
      "duration_ms": 182,
      "error": null,
      "at": "2026-11-14T09:30:14.020Z"
    }
  ]
}