Aircraft

List Aircraft

GET /aircraft/index.json

Retrieve the fleet list. Pilots (user_group_id > 170) see only active aircraft. Managers see all non-deleted aircraft.

Named Parameters

Parameter	Example	Description
active	active:true	Filter by active status (true or false). Ignored for pilot-level users.
search	search:C172	Filter by registration or model name (partial match)
base_id	base_id:{uuid}	Filter aircraft assigned to a specific base

Response

[
  {
    "Aircraft": {
      "id": "45",
      "registration": "EC-ABC",
      "active": true,
      "multiengine": false,
      "multipilot": false,
      "simulator": false,
      "serial": "172-12345",
      "registration_exp": "2026-09-30",
      "insurance_exp": "2025-12-31",
      "airworthiness_exp": "2026-06-15",
      "radio_exp": "2026-03-01",
      "weight_exp": null,
      "billing": false,
      "photo": "EC_ABC.1682241511.jpg",
      "flight_count": "450",
      "created": "2020-01-15 10:00:00",
      "hours": "12.500",
      "landings": "9",
      "log_reference": "1736925801"
    },
    "AircraftModel": {
      "name": "C172",
      "icao": "C172",
      "aircraft_manufacturer_id": "292",
      "id": "2018",
      "AircraftManufacturer": { "name": "CESSNA" }
    },
    "AircraftLogReference": {
      "total_time": "0.000",
      "landings": "0"
    },
    "Base": { "id": "b1", "name": "Madrid Base" },
    "User": {
      "id": "123",
      "UserDetail": { "name": "John", "surname": "Doe", "id": "123" }
    }
  }
]

Aircraft.hours and Aircraft.landings are the running totals from the aircraft logbook (decimal hours string and integer count). Aircraft.log_reference is a Unix timestamp of the last logbook entry. AircraftLogReference.total_time / landings are the baseline reference values (often null or 0.000 when no reference has been set). User is null when no default pilot is assigned.

---

My Aircraft

GET /aircraft/my_aircraft.json

Retrieve aircraft attributed to the authenticated user.

Response

{
  "aircraft": [
    {
      "id": "45",
      "active": true,
      "title": "EC-ABC",
      "photo": "https://...",
      "manufacturer": "Cessna",
      "model": "C172"
    }
  ]
}

---

View Aircraft

GET /aircraft/view/{id}.json

Retrieve full details for a single aircraft, including maintenance, rates, and logbook reference.

Path Parameters

Parameter	Type	Description
id	string	Aircraft ID

Response

{
  "Aircraft": {
    "id": "45",
    "active": true,
    "company_id": "42",
    "base_id": "5",
    "billing": true,
    "auto_bill": false,
    "serial": "172-12345",
    "registration": "EC-ABC",
    "photo": "https://...",
    "multiengine": false,
    "multipilot": false,
    "simulator": false,
    "hobbs": true,
    "tach": false,
    "adsb": "ABC123",
    "self_schedule": true,
    "maintenance": "enabled",
    "fuel_tracking": true,
    "oil_tracking": false,
    "hours": "12500",
    "landings": "8900",
    "flight_count": "4500",
    "airworthiness_exp": "2026-06-15",
    "insurance_exp": "2025-12-31",
    "radio_exp": "2026-03-01",
    "weight_exp": null,
    "avionics_exp": null,
    "registration_exp": "2026-09-30",
    "created": "2020-01-15 10:00:00",
    "modified": "2025-03-01 14:00:00"
  },
  "AircraftModel": {
    "id": "10",
    "name": "C172",
    "icao": "C172",
    "aircraft_manufacturer_id": "1",
    "AircraftManufacturer": { "name": "Cessna" }
  },
  "AircraftLogReference": {
    "total_time": "12000",
    "landings": "8500",
    "created": "2020-01-15"
  },
  "Base": { "name": "Madrid Base", "id": "5", "airport_id": "100" },
  "User": {
    "id": "123",
    "UserDetail": { "name": "John", "surname": "Doe", "id": "123" }
  },
  "DefaultRate": {
    "name": "Standard Rate",
    "hourly_price": "150.00",
    "id": "10"
  },
  "Rate": [
    {
      "id": "10",
      "company_id": "42",
      "deleted": false,
      "name": "Standard Rate",
      "description": "Per flight hour",
      "hourly_price": "150.00",
      "pack": false,
      "hours": null,
      "AircraftRate": { "id": "1", "rate_id": "10", "aircraft_id": "45", "created": "2020-01-15" }
    }
  ],
  "Maintenance": {
    "past": [],
    "future": [
      {
        "Job": {
          "id": "200",
          "name": "100h Inspection",
          "type": "hours",
          "completed": false,
          "hours_now": "12500",
          "hours_added": "100",
          "expiration": null
        }
      }
    ],
    "next": null
  }
}

Expiration Date Fields

All *_exp fields use YYYY-MM-DD format. null means no expiration set.

Field	Description
airworthiness_exp	Airworthiness certificate expiration
insurance_exp	Insurance expiration
radio_exp	Radio station license expiration
weight_exp	Weight & balance check expiration
avionics_exp	Avionics check expiration
registration_exp	Aircraft registration expiration

---

Aircraft Logbook

GET /aircraft/logbook/{aircraftId}/limit:{limit}/page:{page}.json

Retrieve the aircraft technical logbook with pagination.

Path Parameters

Parameter	Type	Description
aircraftId	string	Aircraft ID
limit	number	Records per page (default: 10)
page	number	Page number

Response

{
  "logbook": [
    {
      "AircraftLog": {
        "id": "1000",
        "user_id": "123",
        "aircraft_id": "45",
        "time": "3600",
        "total_time": "12500",
        "landings": "1",
        "total_landings": "8900",
        "type": "flight",
        "foreign_key": "5678",
        "created": "2025-03-10 09:30:00",
        "modified": "2025-03-10 09:30:00"
      },
      "Flight": {
        "id": "5678",
        "date": "2025-03-10",
        "callsign": "EC-ABC",
        "departure_airport": "LEMD",
        "landing_airport": "LEBL",
        "offblocks_time": "08:00:00",
        "onblocks_time": "09:25:00",
        "rules": "VFR",
        "landings": "1",
        "Pic": {
          "id": "123",
          "UserDetail": { "name": "John", "surname": "Doe" }
        }
      }
    }
  ],
  "paging": {
    "page": 1,
    "current": 1,
    "count": 4500,
    "prevPage": false,
    "nextPage": true,
    "pageCount": 450,
    "limit": 10
  }
}

---

Export Logbook (XLS)

GET /aircraft/logbook/{aircraftId}/limit:10000/logbook.xls

Download the aircraft logbook as an Excel file. Token passed as query parameter: ?token=<token>

---

Fuel & Oil Consumptions

GET /aircraft/consumptions/{id}.json

Retrieve monthly average fuel and oil consumption rates. Defaults to last 12 months.

Path Parameters

Parameter	Type	Description
id	string	Aircraft ID

Query Parameters

Parameter	Type	Description
months	integer	Optional. Number of months to look back. Range: 1–120. Default: 12

Response

[
  {
    "month_unix": 1709251200,
    "month": "2025-03",
    "avg_fuel_per_block_hour": 32.5,
    "avg_oil_per_block_hour": 0.2
  }
]

---

Fleet ADSB Positions

GET /aircraft/adsb.json

Retrieve real-time ADSB positions for all aircraft in the fleet with ADSB transponders configured.

Response

[
  {
    "Aircraft": {
      "id": "45",
      "adsb": "ABC123",
      "registration": "EC-ABC",
      "hours": "12500",
      "landings": "8900"
    },
    "AircraftModel": {
      "name": "C172",
      "icao": "C172",
      "manufacturer": "Cessna"
    },
    "AircraftPosition": [
      {
        "id": "9999",
        "aircraft_id": "45",
        "lat": "40.4719",
        "lon": "-3.5626",
        "speed": "120",
        "alt": "5500",
        "ground": false,
        "track": "090",
        "created": "2025-03-10 12:00:00"
      }
    ],
    "lastKnownPosition": [
      {
        "AircraftPosition": {
          "id": "9999",
          "lat": "40.4719",
          "lon": "-3.5626",
          "speed": "120",
          "alt": "5500",
          "ground": false,
          "track": "090",
          "created": "2025-03-10 12:00:00"
        }
      }
    ]
  }
]

---

Aircraft ADSB History

GET /aircraft/adsb/{aircraftId}/{start}/{end}.json

Retrieve ADSB position history for a specific aircraft within a date range.

Path Parameters

Parameter	Type	Description
aircraftId	string	Aircraft ID
start	string	Start date (YYYY-MM-DD)
end	string	End date (YYYY-MM-DD)

---

Manufacturers

GET /aircraft/manufacturers.json

List all aircraft manufacturers.

---

Models by Manufacturer

GET /aircraft/model/{manufacturerId}.json?q={search}

Search aircraft models by manufacturer.

Query Parameters

Parameter	Type	Description
q	string	Search query for model name

---

Create Aircraft

POST /aircraft/add.json

Add a new aircraft to the fleet. Admin access required.

---

Edit Aircraft

POST /aircraft/edit.json

Update aircraft details. Admin access required.

---

Delete Aircraft

GET /aircraft/delete/{id}.json

Remove an aircraft from the fleet. Admin access required.

Path Parameters

Parameter	Type	Description
id	string	Aircraft ID