# Get fleet data

Retrieve aircraft fleet data with pagination capabilities. This endpoint provides access to comprehensive aircraft information including status, specifications, and operational details for both active and inactive aircraft.

Features:
- Returns both active and inactive aircraft in the fleet
- Paginated results with configurable limit (10-50) and offset
- Default sorting by updated date and time (descending)
- Returns complete aircraft details including home base airport information

Response Data:
- Aircraft identification (ID, tail number, name)
- Operational details (type of use, status, number of seats)
- Aircraft category (e.g., HEAVY_JET, LIGHT_JET, HELICOPTER)
- Home base airport information (ICAO, IATA, FAA codes, name, local identifier, AID)
- Timestamps (creation and last update dates)
- Additional notes and metadata

Example Use Case: An operations manager needs to retrieve the complete fleet list to plan aircraft assignments and monitor aircraft status across the organization. The endpoint returns paginated results with detailed airport information for each aircraft's home base.

Endpoint: GET /api/v2/aircraft
Version: 2.4.0
Security: X-Api-Client-Id, X-Auth-Token

## Query parameters:

  - `limit` (integer)
    Maximum number of records to return.
    Example: 20

  - `offset` (integer)
    Number of records to skip before starting to return results.

  - `sort` (string)
    Sort criteria in the format: field direction

Supported sort fields:
- updatedAtDateTime (default: desc)
    Example: "updatedAtDateTime,desc"

## Response 200 fields (application/json):

  - `data` (array)
    The list of aircraft for the current page.

  - `data.id` (string)
    Unique identifier for the aircraft
    Example: "12345"

  - `data.tailNumber` (string)
    Aircraft tail number or registration
    Example: "N123AB"

  - `data.name` (string)
    Aircraft name
    Example: "Gulfstream G650"

  - `data.notes` (string)
    Additional notes about the aircraft
    Example: "Recently serviced"

  - `data.typeOfUse` (string)
    Type of use for the aircraft
    Enum: "CHARTER", "PRIVATE"

  - `data.numberOfSeats` (integer)
    Number of seats in the aircraft
    Example: 14

  - `data.status` (string)
    Status of the aircraft
    Enum: "OTHER", "ACTIVE", "INACTIVE"

  - `data.homeBase` (object)

  - `data.homeBase.id` (string)
    Unique identifier for the airport
    Example: "123"

  - `data.homeBase.name` (string)
    Full name of the airport
    Example: "Vienna International Airport"

  - `data.homeBase.icao` (string)
    ICAO code of the airport
    Example: "LOWW"

  - `data.homeBase.iata` (string)
    IATA code of the airport
    Example: "VIE"

  - `data.homeBase.faa` (string)
    FAA code of the airport (US airports only)
    Example: "KJFK"

  - `data.homeBase.localIdentifier` (string)
    Local identifier code for the airport
    Example: "ABC"

  - `data.homeBase.aid` (string)
    Airport AID (Airport Identifier) code
    Example: "AID123"

  - `data.category` (string)
    Category of the aircraft
    Enum: "PISTON", "TURBO_PROP", "VERY_LIGHT_JET", "LIGHT_JET", "SUPER_LIGHT_JET", "MIDSIZE_JET", "SUPER_MIDSIZE_JET", "HEAVY_JET", "ULTRA_LONG_RANGE_JET", "VIP_JET", "AIRLINER", "AMPHIBIAN", "GYROCOPTER", "HELICOPTER", "SEA_PLANE", "TILT_ROTOR"

  - `data.updatedAtDateTime` (string)
    Date and time when the aircraft was last updated (UTC)
    Example: "2025-01-15T10:30:00.000Z"

  - `data.createdAtDateTime` (string)
    Date and time when the aircraft was created (UTC)
    Example: "2024-01-15T10:30:00.000Z"

  - `pagination` (object)
    Pagination details

  - `pagination.offset` (integer)
    Number of records skipped

  - `pagination.limit` (integer)
    Maximum number of records returned
    Example: 20

  - `pagination.totalItems` (integer)
    Total number of items available
    Example: 150

  - `pagination.sortItems` (array)
    List of fields used for sorting
    Example: ["issueDate desc"]

  - `pagination.filters` (array)
    List of applied filters

  - `pagination.filters.field` (string)
    Field name to filter by
    Example: "issueDate"

  - `pagination.filters.operator` (string)
    Filter operator
    Example: "gte"

  - `pagination.filters.value` (string)
    Filter value
    Example: "2024-01-01T00:00:00.000Z"


## Response 400 fields

## Response 401 fields

## Response 403 fields