Skip to main content
The FBO endpoints manage Fixed Base Operator operations including flight board movements, service orders, fuel orders, customer profiles, and activity logging. Base path: /api/v1/fbo All FBO endpoints require authentication.

​
Movements (Flight Board)

Manage inbound, outbound, and on-ground aircraft movements displayed on the FBO flight board.
MethodPathDescription
GET/movementsList movements (paginated)
GET/movements/:idGet a single movement
POST/movementsCreate a movement
PATCH/movements/:idUpdate a movement
DELETE/movements/:idDelete a movement

​
List Movements

curl -X GET "https://api.planeconnection.com/api/v1/fbo/movements?page=1&page_size=20&status=confirmed&date=2026-04-01" \
  -H "Authorization: Bearer $TOKEN"
Query parameters:
ParameterTypeDescription
pageintegerPage number (default: 1)
page_sizeintegerItems per page (default: 20, max: 100)
statusstringFilter by status
datestringFilter by movement date (YYYY-MM-DD)
searchstringSearch by tail number

​
Create Movement

curl -X POST "https://api.planeconnection.com/api/v1/fbo/movements" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "direction": "inbound",
    "status": "confirmed",
    "tailNumber": "N12345",
    "aircraftType": "Cessna Citation CJ4",
    "movementDate": "2026-04-01",
    "origin": "KJFK",
    "destination": "KTEB",
    "eta": "2026-04-01T14:30:00Z",
    "operator": "Skyline Aviation",
    "pob": 4,
    "customs": "Domestic",
    "parking": "Ramp B-3",
    "isVip": 1
  }'
Direction values: inbound, outbound, on_ground Status values: confirmed, tentative, in_progress, completed, delayed, cancelled

​
Response

{
  "success": true,
  "data": {
    "id": "mov_abc123",
    "workspaceId": "ws_xyz",
    "direction": "inbound",
    "status": "confirmed",
    "tailNumber": "N12345",
    "aircraftType": "Cessna Citation CJ4",
    "movementDate": "2026-04-01",
    "origin": "KJFK",
    "destination": "KTEB",
    "eta": "2026-04-01T14:30:00Z",
    "operator": "Skyline Aviation",
    "pob": 4,
    "customs": "Domestic",
    "parking": "Ramp B-3",
    "isVip": 1,
    "createdAt": "2026-03-20T10:00:00Z",
    "updatedAt": "2026-03-20T10:00:00Z"
  }
}

​
Service Orders

Manage service requests attached to aircraft movements (hangar, GPU, lavatory, deicing, etc.).
MethodPathDescription
GET/service-ordersList service orders
GET/service-orders/:idGet a single service order
POST/service-ordersCreate a service order
PATCH/service-orders/:idUpdate a service order
DELETE/service-orders/:idDelete a service order

​
Create Service Order

curl -X POST "https://api.planeconnection.com/api/v1/fbo/service-orders" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "movementId": "mov_abc123",
    "service": "GPU hookup",
    "status": "pending",
    "assignedTo": "user_xyz",
    "notes": "Aircraft needs GPU power for 2 hours"
  }'
Query parameters:
ParameterTypeDescription
movement_idstringFilter by movement ID
Status values: pending, in_progress, completed, cancelled

​
Fuel Orders

Manage fuel orders for aircraft movements.
MethodPathDescription
GET/fuel-ordersList fuel orders
GET/fuel-orders/:idGet a single fuel order
POST/fuel-ordersCreate a fuel order
PATCH/fuel-orders/:idUpdate a fuel order
DELETE/fuel-orders/:idDelete a fuel order

​
Create Fuel Order

curl -X POST "https://api.planeconnection.com/api/v1/fbo/fuel-orders" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "movementId": "mov_abc123",
    "fuelType": "Jet-A",
    "quantity": 250,
    "pricePerGallon": 6.50,
    "total": 1625.00,
    "status": "pending",
    "truckId": "truck_01"
  }'
Query parameters:
ParameterTypeDescription
movement_idstringFilter by movement ID
Status values: pending, in_progress, completed, cancelled

​
Customer Profiles

Manage FBO customer profiles, loyalty tiers, and fuel discounts.
MethodPathDescription
GET/customersList customers (paginated)
GET/customers/:idGet a single customer profile
POST/customersCreate a customer profile
PATCH/customers/:idUpdate a customer profile
DELETE/customers/:idDelete a customer profile

​
Create Customer Profile

curl -X POST "https://api.planeconnection.com/api/v1/fbo/customers" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Skyline Aviation LLC",
    "loyaltyTier": "platinum",
    "fuelDiscountPct": 5,
    "preferences": "Prefers Ramp A, requires GPU on arrival",
    "notes": "VIP operator, direct billing approved"
  }'
Query parameters:
ParameterTypeDescription
pageintegerPage number (default: 1)
page_sizeintegerItems per page (default: 20, max: 100)
searchstringSearch by customer name

​
Activity Log

An append-only log of events related to movements (arrivals, departures, services, fuel, notes, status changes).
MethodPathDescription
GET/activity-logList activity log entries
POST/activity-logCreate an activity log entry

​
Create Activity Log Entry

curl -X POST "https://api.planeconnection.com/api/v1/fbo/activity-log" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "movementId": "mov_abc123",
    "eventType": "arrival",
    "title": "Aircraft arrived at Ramp B-3",
    "description": "N12345 arrived on time, 4 POB"
  }'
Query parameters:
ParameterTypeDescription
movement_idstringFilter by movement ID
Event types: arrival, departure, service, fuel, note, status
The activity log is append-only. Entries cannot be updated or deleted to maintain an accurate operational audit trail.
Last modified on April 11, 2026