> ## Documentation Index
> Fetch the complete documentation index at: https://docs.series.hr/llms.txt
> Use this file to discover all available pages before exploring further.

# List Flights

> List workspace flights with optional status, route, and date filters

List all scheduled, active, or historical flights for the authenticated workspace.

## Request

```bash theme={null}
curl -X GET "https://api.series.hr/flights/list?status=scheduled&activeOnly=true" \
  -H "apikey: YOUR_API_KEY"
```

## Parameters

<ParamField query="status" type="string">
  Filter by flight status: `scheduled`, `boarding`, `gate_closed`, `departed`, `in_flight`, `landed`, `arrived`, `delayed`, or `cancelled`.
</ParamField>

<ParamField query="airlineId" type="string">
  Filter by operating airline ID.
</ParamField>

<ParamField query="originAirportId" type="string">
  Filter by origin airport ID.
</ParamField>

<ParamField query="destinationAirportId" type="string">
  Filter by destination airport ID.
</ParamField>

<ParamField query="aircraftId" type="string">
  Filter by aircraft fleet ID or aircraft model name.
</ParamField>

<ParamField query="flightNumber" type="string">
  Filter or search by flight number (e.g. `RA 101`).
</ParamField>

<ParamField query="date" type="string">
  Filter flights departing on a specific date (Format: `YYYY-MM-DD`).
</ParamField>

<ParamField query="activeOnly" type="boolean">
  When set to `true`, filters out flights that have already arrived or been cancelled.
</ParamField>

<ParamField query="sort" type="string" default="asc">
  Sort direction by departure time: `asc` (earliest first) or `desc` (latest first).
</ParamField>

<ParamField query="page" type="integer" default="1">
  Pagination page number.
</ParamField>

<ParamField query="limit" type="integer" default="50">
  Number of flights per page (maximum: 100).
</ParamField>

## Response

<ResponseField status={200} name="200">
  ```json theme={null}
  {
    "success": true,
    "data": {
      "WorkspaceId": "a7d5339a-5531-4336-99c6-6f3249c9ac20",
      "WorkspaceName": "Roblox Airways Hub",
      "TotalFlights": 12,
      "Page": 1,
      "Limit": 50,
      "TotalPages": 1,
      "Flights": [
        {
          "FlightId": "flt_1740000000000_abcde",
          "WorkspaceId": "a7d5339a-5531-4336-99c6-6f3249c9ac20",
          "FlightNumber": "RA 101",
          "AirlineId": "airline_1",
          "AirlineName": "Roblox Airways",
          "AirlineIata": "RA",
          "AirlineIcao": "RBA",
          "AirlineCallsign": "ROBLOXAIR",
          "AirlineIcon": "plane",
          "AirlineColorHex": "#0EA5E9",
          "AircraftId": "ac_1",
          "AircraftModel": "Boeing 737-800",
          "AircraftManufacturer": "Boeing",
          "AircraftCapacity": 180,
          "OriginAirportId": "apt_1",
          "OriginAirportName": "Robloxia International",
          "OriginIata": "RBLX",
          "OriginGateId": "gate_1",
          "OriginGateName": "Gate A1",
          "DestinationAirportId": "apt_2",
          "DestinationAirportName": "Blox City Airport",
          "DestinationIata": "BLOX",
          "DestinationGateId": "gate_5",
          "DestinationGateName": "Gate B2",
          "ScheduledDepartureTime": "2026-09-01T14:00:00.000Z",
          "ScheduledArrivalTime": "2026-09-01T14:45:00.000Z",
          "DurationRealMinutes": 45,
          "DurationGameplayMinutes": 15,
          "Status": "scheduled",
          "Classes": [
            {
              "ClassId": "class_eco",
              "ClassName": "Economy Class",
              "ClassCode": "Y",
              "ColorHex": "#0EA5E9",
              "Capacity": 150,
              "BookedSeats": 24,
              "GamepassRequired": false,
              "GamepassId": null
            },
            {
              "ClassId": "class_first",
              "ClassName": "First Class",
              "ClassCode": "F",
              "ColorHex": "#F59E0B",
              "Capacity": 30,
              "BookedSeats": 6,
              "GamepassRequired": true,
              "GamepassId": 12345678,
              "PriorityBoarding": true
            }
          ],
          "TotalAllocatedSeats": 180,
          "CreatedBy": "714760171",
          "CreatedAt": "2026-09-01T10:00:00.000Z",
          "UpdatedAt": "2026-09-01T10:00:00.000Z"
        }
      ],
      "Filters": {
        "status": "scheduled",
        "airlineId": null,
        "originAirportId": null,
        "destinationAirportId": null,
        "flightNumber": null,
        "date": null,
        "activeOnly": true
      }
    }
  }
  ```
</ResponseField>

## Status Codes

* `200`: Flights list returned successfully
* `401`: API key is required or invalid
* `403`: Flights module is not enabled for the workspace