> ## Documentation Index
> Fetch the complete documentation index at: https://docs.planeconnection.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Maintenance endpoints

***

title: "Maintenance API Endpoints"
description: "REST API endpoints for work orders, parts, attestations, reliability, forecast, logbook, and billing."
keywords: \["API", "maintenance", "endpoints", "REST"]
mode: wide

***

The maintenance API provides programmatic access to work orders, parts
inventory, technician attestations, fleet reliability data, maintenance
forecasting, logbook entries, and billing operations.

**Base path:** `/api/v1/maintenance`

All endpoints require authentication via Clerk session cookie or
`X-API-Key` header. Workspace context is provided by the `X-Tenant-*`
headers set by the router worker.

For authentication details, see [Authentication](/en/reference/api/authentication).
For error response formats, see [Errors](/en/reference/api/errors).

<Info>
  **Full schema documentation** — complete request/response schemas with
  field descriptions are available in the **interactive API reference**
  inside your workspace at **Settings > Integrations > API Reference**.
  This page provides an overview of available endpoints and capabilities.
</Info>

## Work Orders

Manage the full lifecycle of maintenance work orders: create, assign,
track progress, record parts and labor, and close with attestation.

**Base path:** `/api/v1/maintenance/work-orders`

| Method | Path                     | Description                                  |
| ------ | ------------------------ | -------------------------------------------- |
| `GET`  | `/work-orders`           | List work orders (paginated, filterable)     |
| `GET`  | `/work-orders/:id`       | Get a single work order with items and notes |
| `POST` | `/work-orders`           | Create a new work order                      |
| `PUT`  | `/work-orders/:id`       | Update a work order                          |
| `POST` | `/work-orders/:id/close` | Close (complete) a work order                |
| `POST` | `/work-orders/:id/items` | Add an item to a work order                  |

**Filterable by:** status, aircraft, assigned technician, priority, date range.

**Example:**

```bash theme={}
curl "https://api.planeconnection.com/api/v1/maintenance/work-orders?status=in_progress&limit=10" \
  -H "Authorization: Bearer $TOKEN"
```

***

## Parts

Inventory management for aviation parts: list, retrieve, issue from
inventory, receive into inventory, and track component time.

**Base path:** `/api/v1/maintenance/parts`

| Method | Path                | Description                                  |
| ------ | ------------------- | -------------------------------------------- |
| `GET`  | `/parts`            | List parts inventory (paginated, filterable) |
| `GET`  | `/parts/:id`        | Get a single part with recent transactions   |
| `POST` | `/parts/issue`      | Issue a part from inventory to a work order  |
| `POST` | `/parts/receive`    | Receive a part into inventory                |
| `GET`  | `/parts/components` | List component time tracking records         |

**Filterable by:** part number, category, storage location, stock level.

***

## Attestations

Create and verify technician attestations for maintenance work. Tracks
certificate attestations per 14 CFR 43.3 and 14 CFR 43.7.

**Base path:** `/api/v1/maintenance/attestations`

| Method | Path                       | Description                               |
| ------ | -------------------------- | ----------------------------------------- |
| `GET`  | `/attestations`            | List attestations (paginated, filterable) |
| `GET`  | `/attestations/:id`        | Get a single attestation                  |
| `POST` | `/attestations`            | Create a new attestation                  |
| `POST` | `/attestations/:id/verify` | Verify an attestation                     |

***

## Reliability

Fleet reliability program data: event queries, monthly trend analysis, and
recurring squawk analysis by ATA chapter per 14 CFR 135.421(e).

**Base path:** `/api/v1/maintenance/reliability`

| Method | Path                   | Description                                     |
| ------ | ---------------------- | ----------------------------------------------- |
| `GET`  | `/reliability`         | List reliability events (paginated, filterable) |
| `GET`  | `/reliability/trends`  | Monthly trend data grouped by event type        |
| `GET`  | `/reliability/squawks` | Recurring squawk analysis by ATA chapter        |

**Filterable by:** aircraft, event type, date range.

***

## Forecast

Upcoming maintenance due items, calendar events, and overdue item tracking.

**Base path:** `/api/v1/maintenance/forecast`

| Method | Path                 | Description                                        |
| ------ | -------------------- | -------------------------------------------------- |
| `GET`  | `/forecast`          | List maintenance due items (paginated, filterable) |
| `GET`  | `/forecast/calendar` | Calendar-formatted maintenance events              |
| `GET`  | `/forecast/overdue`  | Overdue and critical maintenance items             |

**Filterable by:** aircraft, due date, category, status.

***

## Logbook

Maintenance logbook entries per 14 CFR 43.9 content requirements.

**Base path:** `/api/v1/maintenance/logbook`

| Method | Path           | Description                                  |
| ------ | -------------- | -------------------------------------------- |
| `GET`  | `/logbook`     | List logbook entries (paginated, filterable) |
| `POST` | `/logbook`     | Create a logbook entry                       |
| `GET`  | `/logbook/:id` | Get a single logbook entry                   |

***

## Billing

Labor rate management and billing estimate generation for work orders.

**Base path:** `/api/v1/maintenance/billing`

| Method | Path                     | Description                           |
| ------ | ------------------------ | ------------------------------------- |
| `GET`  | `/billing/rates`         | List labor rates                      |
| `POST` | `/billing/rates`         | Create a labor rate                   |
| `GET`  | `/billing/estimates`     | List billing estimates                |
| `POST` | `/billing/estimates`     | Generate an estimate for a work order |
| `GET`  | `/billing/estimates/:id` | Get estimate detail with line items   |

***

## Related

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/en/reference/api/authentication">
    How to authenticate API requests.
  </Card>

  <Card title="Work Order Statuses" icon="list-check" href="/en/reference/work-order-statuses">
    Work order lifecycle and status transitions.
  </Card>

  <Card title="Maintenance Billing Reference" icon="file-invoice-dollar" href="/en/reference/maintenance-billing-reference">
    Billing configuration, estimate lifecycle, and billing types.
  </Card>

  <Card title="Record Integrity" icon="shield-halved" href="/en/explanation/record-integrity">
    How maintenance records are protected by tamper-evident hashing.
  </Card>
</CardGroup>