{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/0xinsider-com/json-schema/0xinsider-com-webhook-delivery-schema.json",
  "title": "WebhookDelivery",
  "description": "Owner-scoped view of one webhook delivery attempt. Deliberately omits the request body and the endpoint signing secret: a delivery log never re-exposes the payload or any secret material.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/0xinsider-com-webhooks-api-openapi.yml#/components/schemas/WebhookDelivery",
  "type": "object",
  "required": [
    "id",
    "object",
    "event_id",
    "event_type",
    "status",
    "attempt_count",
    "next_attempt_at",
    "retry_schedule_reason",
    "created_at"
  ],
  "properties": {
    "id": {
      "type": "integer",
      "format": "int64"
    },
    "object": {
      "type": "string",
      "const": "webhook_delivery"
    },
    "event_id": {
      "type": "string",
      "description": "Stable event id for this delivery; identical across retries of the same logical event."
    },
    "event_type": {
      "$ref": "#/$defs/WebhookEventType"
    },
    "status": {
      "type": "string",
      "description": "Delivery lifecycle state (e.g. pending, delivered, dead_letter)."
    },
    "attempt_count": {
      "type": "integer",
      "description": "Number of delivery attempts made so far."
    },
    "last_response_status": {
      "type": "integer",
      "description": "HTTP status code of the most recent delivery attempt. Omitted until a response (or transport error) has been recorded."
    },
    "last_error": {
      "type": "string",
      "description": "Short description of the most recent delivery failure. Omitted when the last attempt succeeded or none has failed."
    },
    "delivered_at": {
      "type": "string",
      "format": "date-time",
      "description": "When the delivery was first accepted by the destination. Omitted until a delivery succeeds."
    },
    "next_attempt_at": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time",
      "description": "When the next delivery attempt is due, for a delivery whose status is pending or retry. null while an attempt is in flight (processing) and once the delivery is terminal (delivered or dead_letter)."
    },
    "retry_schedule_reason": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "receiver_retry_after",
        "transient_failure",
        "permanent_or_auth_failure",
        "manual_redelivery",
        "configuration_changed",
        null
      ],
      "description": "Why next_attempt_at was scheduled: receiver_retry_after for an accepted Retry-After on a 408, 429, or 5xx response; transient_failure for a network or ordinary transient retry; permanent_or_auth_failure for another non-2xx response; manual_redelivery or configuration_changed for those queue actions. null while an attempt is in flight or once the delivery is terminal."
    },
    "created_at": {
      "type": "string",
      "format": "date-time"
    }
  },
  "$defs": {
    "WebhookEventType": {
      "type": "string",
      "enum": [
        "large_trade_inserted_v2",
        "large_trades_inserted",
        "whale_trades_inserted",
        "live_sports_updated",
        "trader_synced",
        "whale_trader_synced",
        "large_positions_updated",
        "wallet_grade_changed",
        "suspicious_trade_flagged",
        "insider_radar_flag_raised",
        "sharp_money_flow_detected",
        "smart_money_flow_detected",
        "export_job_ready",
        "export_job_failed",
        "export_job_expired",
        "export_job_cancelled"
      ]
    }
  }
}