> For the complete documentation index, see [llms.txt](https://docs.flylogs.com/fcom/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flylogs.com/fcom/api-docs/reference/safety-reports.md).

# Safety Reports

Requires a **premium** or **unlimited** company plan.

***

## Enumerations

### Severity

Severity is **scoped to the report's `type`** (see below): an Occurrence is always `incident` or `accident`; Safety Information is always `information` or `hazard`.

| Value         | Name        | Color     | Belongs to type |
| ------------- | ----------- | --------- | --------------- |
| `incident`    | Incident    | `#fcd319` | `OCCURRENCE`    |
| `accident`    | Accident    | `#ff260a` | `OCCURRENCE`    |
| `information` | Information | `#1f6ac4` | `INFORMATION`   |
| `hazard`      | Hazard      | `#fc19c3` | `INFORMATION`   |

### Status

| Value       | Name      | Color     |
| ----------- | --------- | --------- |
| `open`      | Open      | `#ff9900` |
| `reviewed`  | Reviewed  | `#ffcc00` |
| `closed`    | Closed    | `#999999` |
| `published` | Published | `#34eb77` |

### Type (ICAO Annex 19 classification)

Chosen by the reporter when the report is created. Orthogonal to `severity` — it records *what kind of report* this is, per ICAO Annex 19, which distinguishes safety occurrences (events) from safety information (broader data/knowledge).

| Value         | Name               | Description                                                                                                                                                     |
| ------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `OCCURRENCE`  | Safety Occurrence  | A specific event or condition that happened (or could happen) and affects aviation safety — accidents, serious incidents, incidents, hazards that materialised. |
| `INFORMATION` | Safety Information | Broader safety data/knowledge used to improve safety (FDM/FOQA, audits, surveys, SPIs, bulletins, ADs...). May or may not describe an occurrence.               |

Defaults to `OCCURRENCE`. Existing reports created before this field was introduced are `OCCURRENCE`.

### Flight Phase

| Code  | Name                 |
| ----- | -------------------- |
| `APR` | Approach             |
| `EMG` | Emergency Descent    |
| `ENR` | En Route             |
| `ICL` | Initial Climb        |
| `LDG` | Landing              |
| `MNV` | Maneuvering          |
| `PIM` | Post-Impact          |
| `PBT` | Pushback/Towing      |
| `STD` | Standing             |
| `TOF` | Takeoff              |
| `TXI` | Taxi                 |
| `UND` | Uncontrolled Descent |
| `UNK` | Unknown              |

### Risk Probability

| Value        | Label                  |
| ------------ | ---------------------- |
| `likely`     | 5 Frequent             |
| `probable`   | 4 Occasional           |
| `possible`   | 3 Remote               |
| `improbable` | 2 Improbable           |
| `remote`     | 1 Extremely Improbable |

Numbering follows the ICAO Doc 9859 probability scale: 5 is the most likely (`Frequent`), 1 the least (`Extremely Improbable`).

### Risk Severity

| Value          | Label          |
| -------------- | -------------- |
| `catastrophic` | A Catastrophic |
| `hazardous`    | B Hazardous    |
| `critical`     | C Major        |
| `marginal`     | D Minor        |
| `negligible`   | E Negligible   |

### Damages

| Value          | Description        |
| -------------- | ------------------ |
| `none`         | None               |
| `minimal`      | Minimal            |
| `important`    | Important          |
| `catastrophic` | Aircraft destroyed |

### Personal Damages

| Value        | Description                        |
| ------------ | ---------------------------------- |
| `none`       | No Injuries                        |
| `injuries`   | Light injuries, no hospitalization |
| `serious`    | Serious injuries                   |
| `casualties` | Loss of Life                       |

***

## Access Control

| user\_group\_id | Access                                          |
| --------------- | ----------------------------------------------- |
| ≤ 110           | Full access: view all reports, edit any, delete |
| 111–150         | View all reports, edit own / crew reports       |
| > 150           | View only own reports and `published` reports   |

***

## List Safety Reports

<mark style="color:blue;">`GET`</mark> `/safety_reports/index.json`

<mark style="color:blue;">`GET`</mark> `/safety_reports/index/{flightId}.json`

List safety reports for the company. Only top-level reports (no `parent_id`) are returned. Users with `user_group_id > 150` see only reports where they are the reporter, PIC, SIC, supervisor, or the report is `published`. Results are paginated: default page size 25, maximum 100. Use the `limit` and `page` named parameters to navigate; the response includes a `paginate` object with the total count and page information.

#### Path Parameters

| Parameter | Type | Description                                           |
| --------- | ---- | ----------------------------------------------------- |
| flightId  | UUID | Optional. Filter reports linked to a specific flight. |

#### Named Parameters

| Parameter        | Example             | Description                                    |
| ---------------- | ------------------- | ---------------------------------------------- |
| limit            | `limit:50`          | Page size (default 25, max 100)                |
| page             | `page:2`            | Page number (default 1)                        |
| status           | `status:open`       | Filter by status value                         |
| report\_category | `report_category:3` | Filter by category ID                          |
| severity         | `severity:incident` | Filter by severity value                       |
| department       | `department:2`      | Filter by department ID                        |
| from             | `from:2025-01-01`   | Reports on or after this date                  |
| to               | `to:2025-12-31`     | Reports on or before this date                 |
| excel            | `excel:true`        | Download as Excel (requires token query param) |

#### Response

```json
{
  "reports": [
    {
      "SafetyReport": {
        "id": "150",
        "idn": "2025/00042",
        "name": "Bird strike on approach",
        "severity": "incident",
        "type": "OCCURRENCE",
        "status": "open",
        "datetime": "2025-03-10 09:15:00",
        "location": "LEMD",
        "air_space": "controlled",
        "flight_phase": "APR"
      },
      "Flight": {
        "user_id": "123",
        "pic_id": "123",
        "sic_id": null,
        "supervisor_id": null
      },
      "SafetyReportCategory": {
        "id": "3",
        "short": "OPS",
        "name": "Operational"
      },
      "SafetyReportDepartment": {
        "id": "2",
        "name": "Flight Operations - ATO"
      },
      "ChildSafetyReport": []
    }
  ],
  "paginate": {
    "page": 1,
    "current": 25,
    "count": 132,
    "prevPage": false,
    "nextPage": true,
    "pageCount": 6,
    "limit": 25
  },
  "status": {
    "open":      { "name": "Open",      "icon": "fa fa-envelope-open",      "color": "#ff9900" },
    "reviewed":  { "name": "Reviewed",  "icon": "fa fa-envelope-open-text", "color": "#ffcc00" },
    "closed":    { "name": "Closed",    "icon": "fa fa-envelope",           "color": "#999999" },
    "published": { "name": "Published", "icon": "fa fa-newspaper",          "color": "#34eb77" }
  },
  "severity": {
    "information": { "name": "Information", "icon": "fa fa-info-circle",         "color": "#1f6ac4" },
    "incident":    { "name": "Incident",    "icon": "fa fa-exclamation-circle",  "color": "#fcd319" },
    "accident":    { "name": "Accident",    "icon": "fa fa-exclamation-triangle","color": "#ff260a" },
    "hazard":      { "name": "Hazard",      "icon": "fa fa-bolt",               "color": "#fc19c3" }
  },
  "reportTypes": { "3": "Operational", "4": "Maintenance" },
  "reportKinds": {
    "OCCURRENCE":  { "name": "Safety Occurrence",  "icon": "fa fa-flag",        "color": "#0d9488" },
    "INFORMATION": { "name": "Safety Information",  "icon": "fa fa-circle-info", "color": "#1f6ac4" }
  },
  "severities":  { "information": "Information", "incident": "Incident", "accident": "Accident", "hazard": "Hazard" },
  "statuses":    { "open": "Open", "reviewed": "Reviewed", "closed": "Closed", "published": "Published" }
}
```

***

## View Safety Report

<mark style="color:blue;">`GET`</mark> `/safety_reports/view/{id}.json`

Full details for a single report including flight, aircraft, and reporter.

> `created` and `modified` are unix timestamps (integers, seconds since epoch). `datetime` is a `YYYY-MM-DD HH:MM:SS` string.

#### Path Parameters

| Parameter | Type | Description      |
| --------- | ---- | ---------------- |
| id        | UUID | Safety report ID |

#### Response

```json
{
  "allowEdit": true,
  "report": {
    "SafetyReport": {
      "id": "150",
      "company_id": "42",
      "user_id": "123",
      "flight_id": "5678",
      "idn": "2025/00042",
      "safety_report_category_id": "3",
      "safety_report_department_id": "2",
      "reported": true,
      "parent_id": null,
      "flight_type_id": "1",
      "status": "open",
      "severity": "incident",
      "type": "OCCURRENCE",
      "name": "Bird strike on approach",
      "datetime": "2025-03-10 09:15:00",
      "location": "LEMD",
      "air_space": "controlled",
      "flight_phase": "APR",
      "events": "Single bird strike on left wing during ILS approach RWY 32L",
      "actions": "Continued approach, reported to ATC",
      "result": "No damage found on post-flight inspection",
      "corrective_measures": "Area wildlife management notified",
      "met_conditions": "CAVOK",
      "damages": "none",
      "personal_damages": "none",
      "risk_probability": "possible",
      "mitigated_risk_probability": "improbable",
      "risk_severity": "marginal",
      "mitigated_risk_severity": "negligible",
      "anonymous": false,
      "created": 1741608000,
      "modified": 1741617000
    },
    "Reporter": {
      "id": "123",
      "UserDetail": { "name": "John", "surname": "Doe", "id": "123" },
      "UserGroup": { "name": "Pilot" }
    },
    "SafetyReportCategory": { "id": "3", "short": "OPS", "name": "Operational" },
    "SafetyReportDepartment": { "id": "2", "name": "Flight Operations - ATO" },
    "ParentSafetyReport": { "idn": null, "ParentSafetyReport": [] },
    "FlightType": { "name": "Training" },
    "Aircraft": [
      {
        "id": "45",
        "registration": "EC-ABC",
        "photo": "https://...",
        "AircraftModel": {
          "name": "C172",
          "AircraftManufacturer": { "name": "Cessna", "Country": { "name": "United States" } }
        }
      }
    ],
    "Flight": {
      "id": "5678",
      "date": "2025-03-10",
      "user_id": "123",
      "callsign": "EC-ABC",
      "departure_airport": "LEBL",
      "landing_airport": "LEMD",
      "offblocks_time": "07:30:00",
      "onblocks_time": "09:25:00",
      "block_time": "6900",
      "rules": "IFR",
      "Pic": { "id": "123", "UserDetail": { "name": "John", "surname": "Doe", "id": "123" } },
      "Sic": null,
      "AircraftLog": []
    },
    "ChildSafetyReport": []
  }
}
```

> `allowEdit` is `true` for managers (`user_group_id < 111`), the report creator, or any flight crew member, provided the report is not deleted.

***

## Export Safety Report (PDF)

<mark style="color:blue;">`GET`</mark> `/safety_reports/view/{id}/pdf:true?token=<token>`

Download a safety report as PDF.

***

## Export Safety Reports (XLS)

<mark style="color:blue;">`GET`</mark> `/safety_reports/index/from:{from}/to:{to}/status:{status}/report_category:{category}/severity:{severity}/excel:true?token=<token>`

Download filtered safety reports as Excel. Same named params as the list endpoint.

***

## Create Safety Report

<mark style="color:green;">`POST`</mark> `/safety_reports/create.json`

<mark style="color:green;">`POST`</mark> `/safety_reports/create/{flightId}.json`

Create a new safety report. Status is always set to `open`. Severity is derived automatically from `damages` and `personal_damages`. An `idn` is auto-generated (`YYYY/NNNNN`); child reports get `parentIdn-N`.

On creation, the system sends notifications to crew members listed in `crew` and to all company managers/safety officers.

#### Request Body

| Field                                       | Type    | Required | Description                                                                                                           |
| ------------------------------------------- | ------- | -------- | --------------------------------------------------------------------------------------------------------------------- |
| SafetyReport.name                           | string  | Yes      | Short event name                                                                                                      |
| SafetyReport.type                           | string  | No       | ICAO Annex 19 classification: `OCCURRENCE` (default) or `INFORMATION`                                                 |
| SafetyReport.severity                       | string  | No       | Only for `type` = `INFORMATION`: `information` (default) or `hazard`. Ignored for Occurrences (derived from damages). |
| SafetyReport.datetime                       | string  | Yes      | Event date/time (ISO 8601)                                                                                            |
| SafetyReport.location                       | string  | Yes      | Event location (ICAO or free text)                                                                                    |
| SafetyReport.events                         | string  | Yes      | Description of what happened                                                                                          |
| SafetyReport.flight\_phase                  | string  | Yes      | Flight phase code (see enumerations)                                                                                  |
| SafetyReport.safety\_report\_category\_id   | number  | Yes      | Category ID                                                                                                           |
| SafetyReport.safety\_report\_department\_id | number  | No       | Department ID (see [Departments](#list-departments))                                                                  |
| SafetyReport.anonymous                      | boolean | No       | If `true`, reporter identity is not stored                                                                            |
| SafetyReport.flight\_id                     | UUID    | No       | Linked flight ID                                                                                                      |
| SafetyReport.flight\_type\_id               | number  | No       | Flight type ID                                                                                                        |
| SafetyReport.parent\_id                     | UUID    | No       | Parent report ID (creates a child/related report)                                                                     |
| SafetyReport.damages                        | string  | No       | Aircraft damages (see enumerations)                                                                                   |
| SafetyReport.personal\_damages              | string  | No       | Personal damages (see enumerations)                                                                                   |
| SafetyReport.air\_space                     | string  | No       | `controlled` or `uncontrolled`                                                                                        |
| SafetyReport.actions                        | string  | No       | Immediate actions taken                                                                                               |
| SafetyReport.result                         | string  | No       | Outcome                                                                                                               |
| SafetyReport.corrective\_measures           | string  | No       | Corrective measures                                                                                                   |
| SafetyReport.met\_conditions                | string  | No       | Meteorological conditions                                                                                             |
| SafetyReport.risk\_probability              | string  | No       | Risk probability key (see enumerations)                                                                               |
| SafetyReport.risk\_severity                 | string  | No       | Risk severity key (see enumerations)                                                                                  |
| SafetyReport.mitigated\_risk\_probability   | string  | No       | Mitigated probability key                                                                                             |
| SafetyReport.mitigated\_risk\_severity      | string  | No       | Mitigated severity key                                                                                                |
| SafetyReport.Aircraft                       | array   | No       | Array of `{"id": "..."}` objects for linked aircraft (HABTM)                                                          |
| SafetyReport.crew                           | array   | No       | Array of user IDs to notify and request related reports from                                                          |

#### Severity derivation

Severity is determined by `type`:

**When `type` = `OCCURRENCE`** — derived server-side from damages; the posted `severity` is ignored.

| Condition                                        | Derived Severity |
| ------------------------------------------------ | ---------------- |
| `damages` in `important`, `catastrophic`         | `accident`       |
| `personal_damages` in `serious`, `casualties`    | `accident`       |
| Otherwise (incl. `minimal` damage or `injuries`) | `incident`       |

**When `type` = `INFORMATION`** — taken from the posted `severity`: `hazard` if the reporter marks it as a hazard, otherwise `information`. Damages do not affect it.

#### Response

```json
{
  "report": {
    "SafetyReport": {
      "id": "151",
      "idn": "2025/00043",
      "status": "open",
      "severity": "information"
    },
    "Aircraft": []
  }
}
```

***

## Edit Safety Report

<mark style="color:green;">`POST`</mark> `/safety_reports/edit/{id}.json`

<mark style="color:orange;">`PUT`</mark> `/safety_reports/edit/{id}.json`

Update an existing safety report. The `id` can also be supplied in the request body as `SafetyReport.id`.

Edit permission follows the same rules as `allowEdit` in the view endpoint. If the editing user is not the original report creator, the `events` and `actions` fields are protected and cannot be changed.

On save, managers and the report owner are notified. If the status changed, the notification includes the old and new status.

#### Request Body

Same fields as create (all optional on edit), wrapped under `SafetyReport`.

#### Response

```json
{
  "result": true,
  "message": "The safety report has been saved."
}
```

***

## Delete Safety Report

<mark style="color:red;">`GET`</mark> `/safety_reports/delete/{id}.json`

Soft-delete a safety report and all its child reports (sets `deleted = true`). Restricted to managers (`user_group_id ≤ 110`).

#### Path Parameters

| Parameter | Type | Description      |
| --------- | ---- | ---------------- |
| id        | UUID | Safety report ID |

#### Response

```json
{
  "result": true,
  "message": "The safety report has been deleted."
}
```

***

## Stats

<mark style="color:blue;">`GET`</mark> `/safety_reports/stats.json`

Returns reference data for building statistics views: status, severity, flight phase, damages, and personal damages enumerations.

#### Response

```json
{
  "status": { ... },
  "severity": { ... },
  "flightPhase": {
    "APR": "Approach",
    "EMG": "Emergency Descent",
    "ENR": "En Route",
    "ICL": "Initial Climb",
    "LDG": "Landing",
    "MNV": "Maneuvering",
    "PIM": "Post-Impact",
    "PBT": "Pushback/Towing",
    "STD": "Standing",
    "TOF": "Takeoff",
    "TXI": "Taxi",
    "UND": "Uncontrolled Descent",
    "UNK": "Unknown"
  },
  "damages": {
    "none": "None",
    "minimal": "Minimal",
    "important": "Important",
    "catastrophic": "Aircraft destroyed"
  },
  "personalDamages": {
    "none": "No Injuries",
    "injuries": "Light injuries, no hospitalization.",
    "serious": "Serious injuries",
    "casualties": "Loss of Life"
  }
}
```

***

## Reports by Month

<mark style="color:blue;">`GET`</mark> `/safety_reports/reports_by_month/{months}.json`

Report counts per month, broken down by severity. Default: last 6 months.

#### Path Parameters

| Parameter | Type   | Description                                   |
| --------- | ------ | --------------------------------------------- |
| months    | number | Number of past months to include (default: 6) |

#### Response

```json
{
  "data": [
    {
      "timestamp": "2025 Jan",
      "total": 12,
      "accidents": 1,
      "incidents": 4,
      "inforepos": 6,
      "hazards": 1
    }
  ]
}
```

***

## Reports by Flight Type

<mark style="color:blue;">`GET`</mark> `/safety_reports/reports_by_flight_type.json`

<mark style="color:blue;">`GET`</mark> `/safety_reports/reports_by_flight_type/year:{year}.json`

Report counts grouped by flight type.

#### Named Parameters

| Parameter | Example     | Description    |
| --------- | ----------- | -------------- |
| year      | `year:2025` | Filter by year |

#### Response

```json
{
  "totals": [
    { "name": "Training", "color": "#3498db", "total": 8 },
    { "name": "Revenue",  "color": "#2ecc71", "total": 3 }
  ]
}
```

***

## Reports by Category

<mark style="color:blue;">`GET`</mark> `/safety_reports/reports_by_category.json`

<mark style="color:blue;">`GET`</mark> `/safety_reports/reports_by_category/year:{year}.json`

Report counts grouped by safety report category.

#### Named Parameters

| Parameter | Example     | Description    |
| --------- | ----------- | -------------- |
| year      | `year:2025` | Filter by year |

#### Response

```json
{
  "totals": [
    { "name": "Operational", "color": "#a1b2c3", "total": 10 },
    { "name": "Maintenance", "color": "#d4e5f6", "total": 4 }
  ]
}
```

***

## Reports by Severity

<mark style="color:blue;">`GET`</mark> `/safety_reports/reports_by_severity.json`

<mark style="color:blue;">`GET`</mark> `/safety_reports/reports_by_severity/year:{year}.json`

Report counts grouped by severity level.

#### Named Parameters

| Parameter | Example     | Description    |
| --------- | ----------- | -------------- |
| year      | `year:2025` | Filter by year |

#### Response

```json
{
  "totals": [
    { "name": "Information", "color": "#1f6ac4", "total": 18 },
    { "name": "Incident",    "color": "#fcd319", "total": 5 },
    { "name": "Accident",    "color": "#ff260a", "total": 1 },
    { "name": "Hazard",      "color": "#fc19c3", "total": 2 }
  ]
}
```

***

## Reports by Flight Phase

<mark style="color:blue;">`GET`</mark> `/safety_reports/reports_by_flight_phase.json`

<mark style="color:blue;">`GET`</mark> `/safety_reports/reports_by_flight_phase/year:{year}.json`

Report counts grouped by flight phase.

#### Named Parameters

| Parameter | Example     | Description    |
| --------- | ----------- | -------------- |
| year      | `year:2025` | Filter by year |

#### Response

```json
{
  "totals": [
    { "name": "Approach", "color": "#a1b2c3", "total": 7 },
    { "name": "Landing",  "color": "#d4e5f6", "total": 4 }
  ]
}
```

***

## Reports by Department

<mark style="color:blue;">`GET`</mark> `/safety_reports/reports_by_department.json`

<mark style="color:blue;">`GET`</mark> `/safety_reports/reports_by_department/year:{year}.json`

Report counts grouped by department. Reports with no department assigned are excluded.

#### Named Parameters

| Parameter | Example     | Description    |
| --------- | ----------- | -------------- |
| year      | `year:2025` | Filter by year |

#### Response

```json
{
  "totals": [
    { "name": "Flight Operations - AOC", "total": 12 },
    { "name": "Maintenance & Engineering - CAMO", "total": 5 },
    { "name": "Cabin Crew", "total": 3 }
  ]
}
```

***

## List Departments

<mark style="color:blue;">`GET`</mark> `/safety_reports/departments.json`

Returns all configured departments sorted by name. Used to populate department dropdown selectors.

#### Response

```json
[
  { "id": "7", "name": "Administration & Safety Office" },
  { "id": "5", "name": "Cabin Crew" },
  { "id": "1", "name": "Flight Operations - AOC" },
  { "id": "2", "name": "Flight Operations - ATO" },
  { "id": "3", "name": "Flight Operations - SPO" },
  { "id": "6", "name": "Ground Handling / Facilities" },
  { "id": "4", "name": "Maintenance & Engineering - CAMO" }
]
```

***

## List Categories

<mark style="color:blue;">`GET`</mark> `/safety_reports/categories/{departmentId}.json`

Returns categories configured for a department, as an `id => name` map. Used to populate category dropdown selectors once a department is selected. `departmentId` is required; a missing value returns a 404.

#### Path Parameters

| Parameter    | Type   | Description                                          |
| ------------ | ------ | ---------------------------------------------------- |
| departmentId | number | Department ID (see [Departments](#list-departments)) |

#### Response

```json
{
  "131": "Hazard Report",
  "132": "Safety Concern",
  "133": "Near Miss",
  "134": "Observation",
  "135": "Unsafe Act",
  "136": "Unsafe Condition",
  "137": "Human Factors",
  "138": "Fatigue",
  "139": "Communication Breakdown",
  "140": "Procedure Not Followed",
  "141": "Training Deficiency",
  "142": "Equipment Failure",
  "143": "Security Event",
  "144": "Environmental Event",
  "145": "Regulatory Non-Compliance",
  "146": "Audit Finding",
  "147": "Safety Suggestion",
  "148": "Emergency Response Issue",
  "149": "Lessons Learned",
  "150": "Other"
}
```