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.
For error response formats, see Errors.
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.
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 |
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 |
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 |
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 |
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
Authentication
How to authenticate API requests.
Work Order Statuses
Work order lifecycle and status transitions.
Maintenance Billing Reference
Billing configuration, estimate lifecycle, and billing types.
Record Integrity
How maintenance records are protected by tamper-evident hashing.