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.

Path Parameters

Parameter	Type	Description
id	string	Aircraft ID

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