{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://secureassure.app/api/partners/schema/track-envelope-1.0.0.json","title":"ATLAS USEIF Track Envelope","description":"Canonical envelope for a single sensor observation as returned by /api/live-feed/tracks and pushed via /api/live-feed/stream. Stable for v1.x.","type":"object","required":["observationId","sourceDomain","position","identification","timestamp"],"properties":{"observationId":{"type":"string","description":"Unique per observation. Stable across deduplication."},"sourceSystem":{"type":"string","description":"Origin pipeline: DB-PERSISTED, ADSBLOL, OPENSKY, CoT-INBOUND, ESMS-RF, ACOUSTIC, etc."},"sourceDomain":{"type":"string","enum":["AIR","MARITIME","GROUND","SPACE","CYBER","RF","ACOUSTIC"]},"sensorType":{"type":"string","description":"ADSB, RADAR, EO_IR, RF, ACOUSTIC, AIS, CoT, etc."},"protocol":{"type":"string","description":"Native message protocol (ASTERIX, NMEA, CoT, etc.)"},"position":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"alt":{"type":"number","description":"Meters above mean sea level."},"cep_m":{"type":"number","description":"Circular Error Probable in meters."}}},"velocity":{"type":"object","properties":{"heading_deg":{"type":"number","minimum":0,"maximum":360},"speed_mps":{"type":"number"},"climb_mps":{"type":"number"}}},"identification":{"type":"object","properties":{"category":{"type":"string","enum":["AIRCRAFT","UAS","MARITIME","GROUND","RF_EMITTER","UNKNOWN"]},"specificType":{"type":"string"},"iff":{"type":"string","enum":["FRIEND","ASSUMED_FRIEND","NEUTRAL","SUSPECT","HOSTILE","UNKNOWN"]},"trackId":{"type":"string"},"callsign":{"type":"string"}}},"threatAssessment":{"type":"object","description":"DECIDE-layer assessment. Present on AIR/UAS/MARITIME tracks.","properties":{"priority":{"type":"string","enum":["CRITICAL","HIGH","MEDIUM","LOW","ROUTINE"]},"echelon":{"type":"string"},"actionRequired":{"type":"string"},"reasons":{"type":"array","items":{"type":"string"}}}},"confidence":{"type":"number","minimum":0,"maximum":1},"timestamp":{"type":"string","format":"date-time"},"signatureData":{"type":"object","description":"Raw sensor-specific signature payload. Schema varies by sensorType."},"classification":{"type":"string","enum":["UNCLASSIFIED","CUI","SECRET","TS"],"default":"UNCLASSIFIED"},"ttl_seconds":{"type":"number","description":"How long the consumer should keep this observation before staling it."}},"examples":[{"observationId":"obs-adsb-a601ee-1779727435487","sourceSystem":"DB-PERSISTED","sourceDomain":"AIR","sensorType":"ADSB","protocol":"ASTERIX","position":{"lat":29.746927,"lon":-97.527574,"alt":891.54,"cep_m":10},"velocity":{"heading_deg":183.77,"speed_mps":46.91,"climb_mps":0},"identification":{"category":"AIRCRAFT","specificType":"General Aviation (US Registered)","iff":"ASSUMED_FRIEND","trackId":"A601EE","callsign":"N4865D"},"threatAssessment":{"priority":"ROUTINE","echelon":"GENERAL_AVIATION","actionRequired":"MONITOR","reasons":[]},"confidence":0.95,"timestamp":"2026-05-25T14:10:28.000Z","classification":"UNCLASSIFIED","ttl_seconds":60}]}