{"openapi":"3.1.0","info":{"title":"10-8 Systems — Incident Export Webhook","version":"1.0.1","description":"Real-time webhook export of incidents/calls for service from 10-8 Systems.\n\nEvents are triggered when calls are **created**, **modified**, **closed**, or **reopened**.\n10-8 Systems sends an HTTP `POST` to the subscriber's configured endpoint with the payload\ndescribed below. The subscriber must respond with a `200` status code to acknowledge receipt.\n\n## Delivery Guarantees\n\nEvents are delivered via a **FIFO (first-in, first-out) queue**, preserving the original\norder in which incidents were created or modified.\n\nIf the subscriber endpoint does not return a `200` response, the event remains in the queue\nand delivery is retried. Events that continue to fail are held in the queue for **up to 2 days**,\nafter which they are purged. While events are pending or being retried, subsequent events for\nthe same subscriber remain queued behind them to preserve order.\n","contact":{"name":"10-8 Systems","url":"https://secure.10-8systems.com"}},"webhooks":{"incidentExport":{"post":{"summary":"Incident created, updated, closed, or reopened","description":"Fired whenever an incident is created, modified, closed, or reopened.\nThe full incident object is included on every event.\n","operationId":"incidentExportEvent","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookPayload"},"examples":{"structureFire":{"$ref":"#/components/examples/StructureFireUpdate"}}}}},"responses":{"200":{"description":"Event acknowledged by subscriber. Any non-200 response causes the event to be\nretried from the FIFO queue for up to 2 days before being purged.\n"}}}}},"components":{"schemas":{"WebhookPayload":{"type":"object","required":["action","incident"],"properties":{"action":{"type":"string","description":"The action that triggered the event.","enum":["new","update","closed","reopened"]},"incident":{"$ref":"#/components/schemas/Incident"}}},"Incident":{"type":"object","description":"Full incident object.","properties":{"callID":{"type":"string","description":"Formatted incident ID string.","example":"24-0285"},"isClosed":{"type":"integer","description":"0 = incident active, 1 = incident closed.","enum":[0,1]},"status":{"type":"string","description":"Incident status.","enum":["Open","Closed"]},"date":{"type":"string","format":"date","description":"Date incident was created (Y-m-d).","example":"2024-11-18"},"time":{"type":"string","description":"Local time incident was created.","example":"14:00:24"},"timestamp":{"type":"integer","description":"Unix timestamp of when incident was created.","example":1731967224},"type":{"type":"string","description":"Incident type.","example":"Structure Fire"},"priority":{"type":"integer","description":"Priority of incident.","minimum":1,"maximum":4},"location":{"type":"string","description":"Full location of incident.","example":"123 Technology Dr, Irvine, CA 92618, USA"},"lat":{"type":"number","format":"double","description":"Latitude of incident location."},"lng":{"type":"number","format":"double","description":"Longitude of incident location."},"address":{"type":"string","description":"Street address of incident location."},"city":{"type":"string"},"county":{"type":"string"},"state":{"type":"string"},"zip":{"type":"string"},"location_notes":{"type":"string"},"xstreet":{"type":"string","description":"Nearest cross-streets to incident location."},"destination_name":{"type":"string","description":"Transport destination."},"rpname":{"type":"string","description":"Caller name."},"rpphone":{"type":"string","description":"Caller phone number."},"rplocation":{"type":"string","description":"Caller location."},"source":{"type":"string","description":"Source of call.","example":"911"},"dispatcher":{"type":"string","description":"Name of user who created incident."},"cases":{"type":"array","items":{"$ref":"#/components/schemas/Case"}},"incidentIDs":{"type":"array","items":{"$ref":"#/components/schemas/IncidentID"}},"persons":{"type":"array","items":{"$ref":"#/components/schemas/Person"}},"vehicles":{"type":"array","items":{"$ref":"#/components/schemas/Vehicle"}},"comments":{"type":"array","items":{"$ref":"#/components/schemas/Comment"}},"units":{"type":"array","description":"Array of unit objects assigned to the incident.","items":{"$ref":"#/components/schemas/Unit"}},"dispositions":{"type":"array","items":{"$ref":"#/components/schemas/Disposition"}},"tags":{"type":"array","description":"Incident tags.","items":{"type":"string"}}}},"Case":{"type":"object","description":"A case number assigned to the incident.","properties":{"id":{"type":"integer","description":"Internal 10-8 Systems ID for case number."},"casePrefix":{"type":"string","description":"Prefix of case number."},"caseID":{"type":"integer","description":"Suffix of case number."},"case":{"type":"string","description":"Formatted case number."},"createdBy":{"type":"integer","description":"Internal 10-8 Systems ID of user that generated case number."}}},"IncidentID":{"type":"object","description":"A responding agency's incident/call ID. Only some agencies will have this configured.","properties":{"id":{"type":"integer","description":"Internal 10-8 Systems ID for agency incident ID."},"incidentPrefix":{"type":"string"},"incidentNumber":{"type":"integer"},"incident_id":{"type":"string","description":"Formatted incident ID."},"agency":{"type":"string","description":"Name of agency to which this incident ID is assigned."}}},"Person":{"type":"object","description":"A person involved in the incident.","properties":{"relation":{"type":"string","description":"Relation of person to the incident (e.g. suspect, witness)."},"notes":{"type":"string"},"uid":{"type":"string","description":"10-8 Systems unique ID of person."},"lastName":{"type":"string"},"firstName":{"type":"string"},"middleName":{"type":"string"},"dob":{"type":"string","description":"Date of birth."},"address":{"type":"string"},"phone":{"type":"string"},"city":{"type":"string"},"county":{"type":"string"},"state":{"type":"string"},"zip":{"type":"integer","description":"Address ZIP code."},"stateID":{"type":"string","description":"Driver license/ID state."},"stateIDNumber":{"type":"string","description":"Driver license/ID number."},"sex":{"type":"string"},"hair":{"type":"string"},"eyes":{"type":"string"},"height":{"type":"string"},"weight":{"type":"string"}}},"Vehicle":{"type":"object","description":"A vehicle involved in the incident.","properties":{"notes":{"type":"string"},"uid":{"type":"string","description":"10-8 Systems unique ID of vehicle."},"license":{"type":"string"},"state":{"type":"string","description":"License plate/tag state."},"vin":{"type":"string"},"type":{"type":"string","description":"Type of vehicle (e.g. 2DR, SUV)."},"make":{"type":"string"},"model":{"type":"string"}}},"Comment":{"type":"object","properties":{"user":{"type":"string","description":"Name of user who created comment."},"comment":{"type":"string"},"time":{"type":"string","description":"Local timestamp string of when comment was added."},"timestamp":{"type":"integer","description":"Unix timestamp of when comment was added."}}},"Unit":{"type":"object","description":"A unit/responder assigned to the incident.","properties":{"unit":{"type":"string","description":"Name of unit/responder assigned to incident."},"department":{"type":"string","description":"Name of department/agency the unit is assigned to."},"run_number":{"type":"string","nullable":true,"description":"Formatted string of response run number."},"dispatched":{"type":"string","description":"Local timestamp of when unit was assigned to the incident."},"time_dispatched":{"type":"integer","nullable":true,"description":"Unix timestamp of dispatched time."},"enroute":{"type":"string","description":"Local timestamp of when unit was placed in en route status."},"time_enroute":{"type":"integer","nullable":true,"description":"Unix timestamp of en route time."},"onscene":{"type":"string","description":"Local timestamp of when unit arrived on scene."},"time_onscene":{"type":"integer","nullable":true,"description":"Unix timestamp of on scene time."},"transporting":{"type":"string","description":"Local timestamp of when unit began transporting/en route to secondary location."},"time_transporting":{"type":"integer","nullable":true,"description":"Unix timestamp of transporting time."},"destination":{"type":"string","description":"Local timestamp of when unit arrived at destination/secondary location."},"time_destination":{"type":"integer","nullable":true,"description":"Unix timestamp of destination time."},"complete":{"type":"string","description":"Local timestamp of when unit was cleared from the incident."},"time_complete":{"type":"integer","nullable":true,"description":"Unix timestamp of complete time."},"destination_name":{"type":"string","nullable":true,"description":"Name of destination/secondary location unit transported to."},"personnel":{"type":"array","items":{"$ref":"#/components/schemas/Personnel"}}}},"Personnel":{"type":"object","description":"A user/person assigned to a responding unit.","properties":{"id":{"type":"integer","description":"Internal 10-8 Systems ID of user."},"name":{"type":"string"},"email":{"type":"string","description":"User email."},"altid":{"type":"string","description":"User alternate ID."},"badge":{"type":"string","description":"User badge number."}}},"Disposition":{"type":"object","description":"A disposition set by the user when the incident was closed.","properties":{"disposition":{"type":"string","description":"Disposition selected by user."},"notes":{"type":"string","description":"Disposition notes entered by user."},"timestamp":{"type":"integer","description":"Unix timestamp of when disposition was submitted."}}}},"examples":{"StructureFireUpdate":{"summary":"Structure fire — update event with multiple responding units","value":{"action":"update","incident":{"callID":"24-0285","isClosed":"0","date":"2024-11-18","time":"14:00:24","status":"Open","type":"Structure Fire","priority":"1","timestamp":"1731967224","location":"123 Technology Dr, Irvine, CA 92618, USA","lat":"33.6624982","lng":"-117.7447592","address":"123 Technology Dr ","city":"Irvine","county":"Orange County","state":"CA","zip":"92618","location_notes":"ABC Apartments","xstreet":"Technology Dr / Barranca Pkwy","destination_name":"","rpname":"JOHN DOE","rpphone":"1234567890","rplocation":"PARKING LOT","source":"911","dispatcher":"Adam Brady","cases":[],"incidentIDs":[{"id":"816","incidentPrefix":"FIRE-2024","incidentNumber":"9295","incident_id":"FIRE-2024-009295","agency":"Fire"}],"persons":[{"relation":"Suspect","uid":"7e42391ffe7554c482b421a1da9c45","lastName":"DOE","firstName":"JOHN","middleName":"SMITH","dob":"2000-01-01","address":"123 TEST ST","phone":"123-456-7890","city":"Irvine","county":"Orange County","state":"CA","zip":"12345","stateID":"CA","stateIDNumber":"A1234567","sex":"M","hair":"BRN","eyes":"BLU","height":"601","weight":"195","notes":"FI'd"}],"vehicles":[{"notes":"Suspect vehicle","uid":"3ee2a66a0e84a0745fc718809c239d","license":"ABC123","state":"CA","vin":"1ABCO983CASOKH428","type":"SUV","make":"FORD","model":"EXPLORER"}],"comments":[{"time":"11-18-2024 14:00:43","user":"Adam Brady","comment":"3 STORY APT COMPLEX / FULL ENGULFED","timestamp":"1731967243"}],"units":[{"unit":"ORGE1","job":"Fire","status":"On Scene","run_number":"FD-24-66","dispatched":"14:01:43 2024-11-18","enroute":"14:01:49 2024-11-18","onscene":"14:01:50 2024-11-18","transporting":"","destination":"","complete":"","time_dispatched":"1731967303","time_enroute":"1731967309","time_onscene":"1731967310","department":"Fire","personnel":[{"id":"8","name":"Jack Bean","email":"","altid":"AB11028","badge":"123"}]}],"disposition":[{"disposition":"Unable To Locate","notes":"Patrol checked area and unable to locate.","timestamp":"1731967290"}],"tags":["Fire","Billable"]}}}}}}