transit402.dev

{
  "additionalProperties": false,
  "properties": {
    "results": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "active_until": {
            "description": "ISO 8601 timestamp when the currently-active period ends, or null if open-ended.",
            "type": [
              "string",
              "null"
            ]
          },
          "description": {
            "description": "Full human-readable description. Often contains specific delay minutes when the MTA provides them.",
            "type": "string"
          },
          "direction": {
            "description": "Which direction is affected. 'both' for route-level alerts or alerts affecting both directions of a stop.",
            "enum": [
              "both",
              "Uptown",
              "Downtown"
            ],
            "type": "string"
          },
          "effect": {
            "description": "Raw GTFS-RT Alert.Effect enum: NO_SERVICE, REDUCED_SERVICE, SIGNIFICANT_DELAYS, DETOUR, ADDITIONAL_SERVICE, MODIFIED_SERVICE, OTHER_EFFECT, UNKNOWN_EFFECT, STOP_MOVED.",
            "type": "string"
          },
          "estimated_minutes": {
            "description": "Delay in minutes extracted from description text when present (e.g. '10-15'). Null when no structured minute estimate is in the alert text.",
            "type": [
              "string",
              "null"
            ]
          },
          "header": {
            "description": "Short summary text from the alert header.",
            "type": "string"
          },
          "lines": {
            "description": "Subway lines affected by this alert.",
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "severity": {
            "description": "Simplified severity bucket normalized from effect. Prefer severity over effect for agent decisioning.",
            "enum": [
              "no_service",
              "reduced",
              "delays",
              "detour",
              "info"
            ],
            "type": "string"
          }
        },
        "required": [
          "lines",
          "effect",
          "severity",
          "direction",
          "header",
          "description"
        ],
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "results"
  ],
  "type": "object"
}