{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://schemas-int.api.qa.finra.org/v1/fifc/fifcIntelligence.json",
  "$dataVersion": 1,
  "title": "fifcIntelligence",
  "description": "External machine-to-machine general-intelligence record (FIFC-2845 / FIFC-2846). One record returned by the Query API get-by-id endpoint.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "id": {
      "type": "string",
      "description": "The record id (UUID).",
      "format": "uuid",
      "maxLength": 36
    },
    "refNumber": {
      "type": "string",
      "description": "The topic reference number (e.g. FIFC-2026-006852).",
      "maxLength": 256
    },
    "title": {
      "type": "string",
      "description": "The topic title.",
      "maxLength": 1024
    },
    "description": {
      "type": ["string", "null"],
      "description": "The full write-up — the active EXECUTIVE_SUMMARY rich-text content (HTML)."
    },
    "version": {
      "type": ["integer", "null"],
      "description": "The optimistic-locking version."
    },
    "isTargeted": {
      "type": "boolean",
      "description": "false = broadcast to all firms, true = targeted to specific firm(s)."
    },
    "categories": {
      "type": ["string", "null"],
      "description": "Comma-joined category names."
    },
    "urgency": {
      "type": ["string", "null"],
      "description": "The urgency name.",
      "maxLength": 256
    },
    "sources": {
      "type": ["string", "null"],
      "description": "Comma-joined source names."
    },
    "intelligenceType": {
      "type": ["string", "null"],
      "description": "The product type name.",
      "maxLength": 256
    },
    "attachments": {
      "type": "array",
      "description": "Downloadable links for uploaded FIST attachments (no inline content). User-entered add-link urls are carried separately in urlLink.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "fileName": {
            "type": ["string", "null"],
            "description": "The attachment file name."
          },
          "url": {
            "type": "string",
            "description": "The FIST download url for the uploaded attachment.",
            "format": "uri"
          }
        },
        "required": ["url"]
      }
    },
    "urlLink": {
      "type": "array",
      "description": "User-entered add-link urls (url-only objects), distinct from uploaded attachments.",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "url": {
            "type": "string",
            "description": "The user-entered add-link url.",
            "format": "uri"
          }
        },
        "required": ["url"]
      }
    },
    "createdDate": {
      "type": "string",
      "description": "The created date, ISO-8601 date-time with offset in US Eastern, whole seconds (e.g. 2026-09-29T14:17:46-04:00).",
      "format": "date-time"
    },
    "updatedDate": {
      "type": ["string", "null"],
      "description": "The updated date, ISO-8601 date-time with offset in US Eastern, whole seconds (e.g. 2026-09-29T14:17:46-04:00).",
      "format": "date-time"
    },
    "activeFlag": {
      "type": "boolean",
      "description": "Active flag derived from the internal Y/N status."
    }
  },
  "required": [
    "id",
    "refNumber",
    "title",
    "isTargeted",
    "createdDate",
    "activeFlag"
  ]
}