> 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/aircraft-reports.md).

# Aircraft Reports

Manage aircraft technical reports (defects, observations, maintenance actions, servicing, restrictions). Requires **premium** or **unlimited** subscription plan.

## List Reports

<mark style="color:green;">`POST`</mark> `/maintenance/aircraft_reports/index.json`

Retrieve a paginated list of aircraft reports for the company fleet.

#### Request Body (optional filters)

| Parameter | Type   | Description                                                                                               |
| --------- | ------ | --------------------------------------------------------------------------------------------------------- |
| aircraft  | number | Filter by aircraft ID                                                                                     |
| flight    | string | Filter by flight UUID                                                                                     |
| type      | string | Filter by report type (`DEFECT`, `OBSERVATION`, `MAINTENANCE_ACTION`, `SERVICING`, `RESTRICTION`, `INFO`) |
| status    | string | Filter by status (`OPEN`, `DEFERRED`, `CLOSED`)                                                           |
| severity  | string | Filter by severity (`LOW`, `MEDIUM`, `HIGH`, `CRITICAL`)                                                  |
| wc        | string | Search in title and description                                                                           |

#### Response

```json
{
  "reports": [
    {
      "AircraftReport": {
        "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "aircraft_id": "45",
        "user_id": "123",
        "type": "DEFECT",
        "title": "Nose gear shimmy above 80kt",
        "description": "Noticeable shimmy on landing roll and takeoff above 80 knots.",
        "ata_chapter": "32",
        "system": "Landing Gear",
        "severity": "MEDIUM",
        "aircraft_status": "FLYABLE",
        "dispatch_condition": "MONITOR",
        "status": "OPEN",
        "hours": "12500.300",
        "cycles": "8900",
        "deferred_until": null,
        "deferred_reference": null,
        "closed_by": null,
        "closed": null,
        "created": "1714003200"
      },
      "Aircraft": {
        "id": "45",
        "registration": "EC-ABC"
      },
      "User": {
        "id": "123",
        "UserDetail": {
          "name": "John",
          "surname": "Doe"
        }
      }
    }
  ],
  "paginate": {
    "page": 1,
    "current": 10,
    "count": 34,
    "prevPage": false,
    "nextPage": true,
    "pageCount": 4,
    "limit": 50
  }
}
```

***

## View Report

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

Retrieve full details for a single aircraft report.

#### Path Parameters

| Parameter | Type   | Description |
| --------- | ------ | ----------- |
| id        | string | Report UUID |

#### Response

```json
{
  "report": {
    "AircraftReport": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "aircraft_id": "45",
      "user_id": "123",
      "type": "DEFECT",
      "title": "Nose gear shimmy above 80kt",
      "description": "Noticeable shimmy on landing roll and takeoff above 80 knots.",
      "ata_chapter": "32",
      "system": "Landing Gear",
      "severity": "MEDIUM",
      "aircraft_status": "FLYABLE",
      "dispatch_condition": "MONITOR",
      "status": "DEFERRED",
      "hours": "12500.300",
      "cycles": "8900",
      "deferred_until": "1717200000",
      "deferred_reference": "MEL-32-01",
      "closed_by": null,
      "closed": null,
      "created": "1714003200"
    },
    "Aircraft": {
      "id": "45",
      "registration": "EC-ABC",
      "AircraftModel": {
        "name": "C172",
        "AircraftManufacturer": {
          "name": "Cessna"
        }
      }
    },
    "User": {
      "id": "123",
      "UserDetail": {
        "name": "John",
        "surname": "Doe"
      }
    },
    "ClosedByUser": {
      "id": null,
      "UserDetail": {
        "name": null,
        "surname": null
      }
    },
    "Job": {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "100h Inspection",
      "status": null,
      "crs": null,
      "start": "1714003200",
      "end": "1714089600"
    }
  }
}
```

***

## Create Report

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

Create a new aircraft report. The authenticated user is automatically set as the reporter and the creation timestamp is set server-side.

After a successful save, an in-app notification is sent to all active company staff (admins, managers, pilots, and mechanics) except the reporter. The notification includes the report title, severity, and aircraft status (FLYABLE / GROUNDED).

#### Request Body

| Parameter                            | Type   | Required | Description                                                                       |
| ------------------------------------ | ------ | -------- | --------------------------------------------------------------------------------- |
| AircraftReport\[aircraft\_id]        | number | yes      | Aircraft ID                                                                       |
| AircraftReport\[type]                | string | yes      | `DEFECT`, `OBSERVATION`, `MAINTENANCE_ACTION`, `SERVICING`, `RESTRICTION`, `INFO` |
| AircraftReport\[title]               | string | yes      | Report title (max 180 chars)                                                      |
| AircraftReport\[description]         | string | no       | Detailed description                                                              |
| AircraftReport\[ata\_chapter]        | string | no       | ATA chapter code (max 10 chars)                                                   |
| AircraftReport\[system]              | string | no       | Aircraft system / ATA description (max 120 chars)                                 |
| AircraftReport\[severity]            | string | no       | `LOW` (default), `MEDIUM`, `HIGH`, `CRITICAL`                                     |
| AircraftReport\[aircraft\_status]    | string | no       | `FLYABLE` (default), `GROUNDED`                                                   |
| AircraftReport\[dispatch\_condition] | string | no       | `NONE` (default), `GROUNDED`, `MEL`, `CDL`, `MONITOR`                             |
| AircraftReport\[status]              | string | no       | `OPEN` (default), `DEFERRED`, `CLOSED`                                            |
| AircraftReport\[flight\_id]          | string | no       | Associated flight UUID                                                            |
| AircraftReport\[hours]               | number | no       | Aircraft hours at time of report                                                  |
| AircraftReport\[cycles]              | number | no       | Aircraft cycles/landings at time of report                                        |
| AircraftReport\[deferred\_until]     | number | no       | Unix timestamp — deferred expiry date                                             |
| AircraftReport\[deferred\_reference] | string | no       | MEL/CDL reference number (max 120 chars)                                          |

#### Response

```json
{
  "data": {
    "aircraft_id": "45",
    "type": "DEFECT",
    "title": "Nose gear shimmy above 80kt",
    "description": "Noticeable shimmy on landing roll and takeoff above 80 knots.",
    "ata_chapter": "32",
    "system": "Landing Gear",
    "severity": "MEDIUM",
    "aircraft_status": "FLYABLE",
    "dispatch_condition": "MONITOR",
    "hours": "12500.300",
    "cycles": "8900",
    "user_id": "123",
    "created": "1714003200"
  },
  "result": {
    "AircraftReport": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "aircraft_id": "45",
      "type": "DEFECT",
      "title": "Nose gear shimmy above 80kt"
    }
  },
  "message": null
}
```

On validation failure, `result` is `false` and `message` contains field errors:

```json
{
  "data": { ... },
  "result": false,
  "message": {
    "title": ["Title is required"],
    "type": ["Invalid type"]
  }
}
```

***

## Edit Report

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

Update an existing aircraft report.

#### Path Parameters

| Parameter | Type   | Description |
| --------- | ------ | ----------- |
| id        | string | Report UUID |

#### Request Body

Same fields as **Create Report**. Only include the fields you want to update.

#### Response

```json
{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "CLOSED",
    "closed_by": "456",
    "closed": "1714608000"
  },
  "result": {
    "AircraftReport": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "status": "CLOSED"
    }
  },
  "message": null
}
```

***

## Delete Report

<mark style="color:blue;">`GET`</mark> `/maintenance/aircraft_reports/delete/{id}.json`

Delete an aircraft report.

#### Path Parameters

| Parameter | Type   | Description |
| --------- | ------ | ----------- |
| id        | string | Report UUID |

#### Response

```json
{
  "result": true,
  "report": {
    "AircraftReport": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "title": "Nose gear shimmy above 80kt"
    },
    "Aircraft": {
      "id": "45",
      "registration": "EC-ABC"
    }
  }
}
```

***

## Enumerations Reference

#### Type

| Value                | Description                                   |
| -------------------- | --------------------------------------------- |
| `DEFECT`             | Technical defect requiring maintenance action |
| `OBSERVATION`        | Observation logged for awareness              |
| `MAINTENANCE_ACTION` | Record of a maintenance action performed      |
| `SERVICING`          | Servicing entry (fluid, tyre, etc.)           |
| `RESTRICTION`        | Operational restriction applied to aircraft   |
| `INFO`               | Informational entry                           |

#### Severity

| Value      | Description                               |
| ---------- | ----------------------------------------- |
| `LOW`      | Low impact — no operational effect        |
| `MEDIUM`   | Moderate impact — monitor required        |
| `HIGH`     | Significant impact — action required soon |
| `CRITICAL` | Immediate action required                 |

#### Aircraft Status

| Value      | Description                      |
| ---------- | -------------------------------- |
| `FLYABLE`  | Aircraft remains airworthy       |
| `GROUNDED` | Aircraft grounded until resolved |

#### Dispatch Condition

| Value      | Description                                   |
| ---------- | --------------------------------------------- |
| `NONE`     | No dispatch condition                         |
| `GROUNDED` | Aircraft may not dispatch                     |
| `MEL`      | Dispatched under Minimum Equipment List       |
| `CDL`      | Dispatched under Configuration Deviation List |
| `MONITOR`  | Dispatched with monitoring requirement        |

#### Status

| Value      | Description                    |
| ---------- | ------------------------------ |
| `OPEN`     | Report is open and active      |
| `DEFERRED` | Report deferred with reference |
| `CLOSED`   | Report resolved and closed     |

***

## ATA Chapters

<mark style="color:blue;">`GET`</mark> `/maintenance/aircraft_reports/ata_chapters.json`

Retrieve the full list of ATA chapter codes and their descriptions, for use when filing reports.

#### Response

```json
{
  "ata_chapters": {
    "05": "Time Limits / Maintenance Checks",
    "06": "Dimensions and Areas",
    "07": "Lifting and Shoring",
    "12": "Servicing",
    "21": "Air Conditioning",
    "22": "Auto Flight",
    "23": "Communications",
    "24": "Electrical Power",
    "25": "Equipment / Furnishings",
    "26": "Fire Protection",
    "27": "Flight Controls",
    "28": "Fuel",
    "29": "Hydraulic Power",
    "30": "Ice and Rain Protection",
    "31": "Indicating / Recording Systems",
    "32": "Landing Gear",
    "33": "Lights",
    "34": "Navigation",
    "35": "Oxygen",
    "49": "APU",
    "51": "Standard Practices – Structures",
    "52": "Doors",
    "53": "Fuselage",
    "71": "Powerplant",
    "72": "Engine",
    "73": "Engine Fuel / Control",
    "74": "Ignition",
    "79": "Oil",
    "80": "Starting"
  }
}
```