Skip to main content

ObligatoryReport Object

Mandatory incident reports filed after safety events during flight operations.
id
number
required
Unique identifier for the report
report_number
string
required
Official report reference number
incident_location
string
required
Location where the incident occurred
description
string
required
Detailed description of the incident
report_date
Date
required
Date when the report was filed
incident_date
Date
required
Date when the incident occurred
incident_time
string
required
Time when the incident occurred
flight_time
string
required
Flight time when incident occurred
pilot
Pilot
required
Pilot in command information
copilot
Pilot
required
Copilot information
aircraft
Aircraft
required
Aircraft involved in the incident
flight_number
string
required
Flight number
flight_origin
string
required
Departure location
flight_destiny
string
required
Destination location
flight_alt_destiny
string
required
Alternate destination
incidents
string
required
Classification of incidents that occurred
other_incidents
string
required
Additional incident information
status
string
required
Report processing status
danger_identification
DangerIdentification
required
Associated danger identification analysis
image
string
Path to incident image file
document
string
Path to incident documentation file
imageUrl
string
URL to access incident image
documentUrl
string
URL to access incident document

VoluntaryReport Object

Voluntary safety reports submitted proactively to identify hazards.
id
number
required
Unique identifier for the report
report_number
string
Report reference number (if assigned)
report_date
Date
required
Date when the report was submitted
identification_date
Date
required
Date when the hazard was identified
danger_location
string
required
Location of the identified hazard
danger_area
string
required
Operational area affected
description
string
required
Detailed description of the hazard
airport_location
string
required
Airport or facility location
possible_consequences
string
required
Potential consequences of the hazard
danger_identification_id
number
required
Associated danger identification ID
danger_identification
DangerIdentification
required
Associated danger identification analysis
status
string
required
Report processing status
reporter_name
string
Name of person submitting report (optional for anonymous reports)
reporter_last_name
string
Last name of reporter
reporter_phone
string
Reporter contact phone
reporter_email
string
Reporter contact email
image
File | string
Image file or path
document
File | string
Document file or path
imageUrl
string
URL to access image
documentUrl
string
URL to access document

Example - ObligatoryReport

{
  "id": 1,
  "report_number": "OR-2026-001",
  "incident_location": "SVMI - Aeropuerto Internacional Simón Bolívar",
  "description": "Bird strike during landing approach",
  "report_date": "2026-03-11T16:00:00Z",
  "incident_date": "2026-03-11T14:30:00Z",
  "incident_time": "14:30",
  "flight_time": "2.5",
  "flight_number": "SG-101",
  "flight_origin": "SVMI",
  "flight_destiny": "SVBC",
  "flight_alt_destiny": "SVVA",
  "status": "UNDER_REVIEW"
}

Example - VoluntaryReport

{
  "id": 5,
  "report_number": "VR-2026-005",
  "report_date": "2026-03-10T09:00:00Z",
  "identification_date": "2026-03-09T15:00:00Z",
  "danger_location": "Hangar 3 - Maintenance Area",
  "danger_area": "MAINTENANCE",
  "description": "Inadequate lighting in engine inspection area",
  "airport_location": "SVMI",
  "possible_consequences": "Potential for missed defects during inspection",
  "status": "OPEN",
  "reporter_name": "Anonymous"
}

Build docs developers (and LLMs) love