Help

Import Flights: JSON

Before you import

Imported flights are added to your logbook on any plan, including the free Frequent Flyer plan. A Crew membership unlocks the advanced features that build on your flight history.

Overview

Flight Import brings your past travel history into MyFlight.Life in a single step.

Import Flights using JSON

Flights can be uploaded in a supported JSON format that captures the airports, dates and flight segments of each trip.

Bulk upload

Up to 1,000 flights or 10 files can be imported over the lifetime of an account — ideal for moving an extensive travel history across at once.

File structure

Flight information

Flight information
Field	Type	Required	Description
`airports`	Array	Required	The airports of the trip, each with its IATA code and whether it was visited. Example: `{ "iata": "DUB", "visited": true }`
`with_return`	Boolean	Required	Whether the flight includes a return trip.
`departure_on`	String	Required	ISO 8601 timestamp of the departure date and time. Example: `2025-02-15T08:35:00.000Z` Note: Do not include a timezone designator — treat dates as generic and timezone-agnostic.
`return_on`	String	Required	ISO 8601 timestamp of the return date and time. Example: `2025-02-18T21:35:00.000Z` Note: For a one-way flight, set this to the same value as departure_on. Note: Do not include a timezone designator — treat dates as generic and timezone-agnostic.

Flight details

Flight details
Field	Type	Required	Description
`flight_type`	Integer	Required	Type of flight — see Flight types in Import codes below.
`legs`	Array	Required	The individual flight segments. Pass an empty array [] when leg data isn't available.

Flight legs

Each entry in the legs array describes a single flight segment.

Flight legs
Field	Type	Required	Description
`order`	Integer	Required	Position of this segment within the trip. Example: `0, 1, 2…`
`airline_mfl_id`	String	Required	IATA identifier of the airline. Pass null when unknown.
`airplane_mfl_id`	String	Required	IATA identifier of the aircraft model. Pass null when unknown.
`flight_number`	String	Required	Flight number for this segment. Pass null when unknown.
`airplane_number`	String	Required	Aircraft registration number. Pass null when unknown.
`seat`	String	Required	Seat for this segment. Pass null when unknown.
`seat_type`	Integer	Required	Type of seat — see Flight seat types in Import codes below.
`flight_class_type`	Integer	Required	Class of this segment — see Flight classes in Import codes below.

Import codes

The integer fields above map to these codes.

Flight types

Flight types
Code	Name	Description
`10`	Leisure	Holidays, personal travel or recreation.
`20`	Business	Professional or work-related travel.
`30`	Crew	Logged as airline or aviation crew duty.
`40`	Private	A flight on a private aircraft.

Flight classes

Flight classes
Code	Name	Description
`10`	Economy	Standard class with basic seating and amenities.
`20`	Premium Economy	More space and service than Economy.
`30`	Business Class	Premium seating with enhanced service.
`40`	First Class	The highest class, with top-tier service.
`50`	Private	A flight on a private aircraft, with no shared cabin.
`60`	Crew	A flight taken as a crew member.
`90`	Other	Any class outside the standard categories.

Flight seat types

Flight seat types
Code	Name	Description
`10`	Window	A seat next to the aircraft window.
`20`	Middle	A seat between the window and aisle.
`30`	Aisle	A seat next to the aisle.
`40`	Private	Exclusive seating on a private aircraft.
`50`	Crew	A seat designated for crew.
`90`	Other	Any seat type outside the standard categories.

Example file

[
  {
    "flight": {
      "airports": [
        { "iata": "DUB", "visited": true },
        { "iata": "JFK", "visited": true }
      ],
      "with_return": false,
      "departure_on": "2025-01-15T08:35:00.000Z",
      "return_on": "2025-01-15T08:35:00.000Z"
    },
    "details": {
      "flight_type": 10,
      "legs": []
    }
  },
  {
    "flight": {
      "airports": [
        { "iata": "DUB", "visited": true },
        { "iata": "AMS", "visited": true },
        { "iata": "KBP", "visited": true }
      ],
      "with_return": true,
      "departure_on": "2025-02-15T08:35:00.000Z",
      "return_on": "2025-02-18T21:35:00.000Z"
    },
    "details": {
      "flight_type": 20,
      "legs": [
        {
          "order": 0,
          "airline_mfl_id": "KL",
          "airplane_mfl_id": "738",
          "flight_number": "KL936",
          "airplane_number": "PH-BXA",
          "seat": "12A",
          "seat_type": 10,
          "flight_class_type": 30
        },
        {
          "order": 1,
          "airline_mfl_id": "KL",
          "airplane_mfl_id": "738",
          "flight_number": "KL3099",
          "airplane_number": "PH-BXA",
          "seat": "12A",
          "seat_type": 10,
          "flight_class_type": 30
        }
      ]
    }
  }
]