---
title: "Create a Flight record"
method: POST
path: "/v3/flights/"
tags: ["flights"]
---

# Create a Flight record

`POST /v3/flights/`

Creation of a Flight record

## Request body

- Flight
  - `id` integer, required
  - `flight_id` integer, required — ID of created flight record
  - `registration_number` string, required — Aircraft registration number
  - `dep_airport_icao` string — Departure airport ICAO code. DEPRECATED: use 'dep_airport' instead
  - `arrival_airport_icao` string — Arrival airport ICAO code. DEPRECATED: use 'arr_airport' instead
  - `dep_date_utc` string, date-time, required — Departure date in format "yyyy-mm-ddThh:mm" (needs to be earlier than "arr_date_utc")
  - `arr_date_utc` string, date-time, required — Arrival date in format "yyyy-mm-ddThh:mm"
  - `comment` string, nullable — Commentary about flight record (should be less than 100 symbols)
  - `dep_airport` ScheduleAirport — Airport. For create/update use one of the fields: 'id', 'name', 'iata', 'icao', 'lid'. Fields are case-insensitive.
    - `id` integer, nullable — airport identifier
    - `name` string, nullable — airport name
    - `iata` string, nullable — airport IATA code
    - `icao` string, nullable — airport ICAO code
    - `lid` string, nullable — Local Identifier
    - `slug` string, nullable
    - `city` ScheduleCity, required
      - `id` integer, required
      - `name` string, required
      - `country` ScheduleCountry, required
        - `id` integer, required
        - `name` string, required
        - `iso_alpha2` string, nullable — ISO 3166-1 alpha-2
        - `iso_alpha3` string, nullable — ISO 3166-1 alpha-3
  - `arr_airport` ScheduleAirport — Airport. For create/update use one of the fields: 'id', 'name', 'iata', 'icao', 'lid'. Fields are case-insensitive.
    - `id` integer, nullable — airport identifier
    - `name` string, nullable — airport name
    - `iata` string, nullable — airport IATA code
    - `icao` string, nullable — airport ICAO code
    - `lid` string, nullable — Local Identifier
    - `slug` string, nullable
    - `city` ScheduleCity, required
      - `id` integer, required
      - `name` string, required
      - `country` ScheduleCountry, required
        - `id` integer, required
        - `name` string, required
        - `iso_alpha2` string, nullable — ISO 3166-1 alpha-2
        - `iso_alpha3` string, nullable — ISO 3166-1 alpha-3

## Response `201`

- Flight
  - `id` integer, required
  - `flight_id` integer, required — ID of created flight record
  - `registration_number` string, required — Aircraft registration number
  - `dep_airport_icao` string — Departure airport ICAO code. DEPRECATED: use 'dep_airport' instead
  - `arrival_airport_icao` string — Arrival airport ICAO code. DEPRECATED: use 'arr_airport' instead
  - `dep_date_utc` string, date-time, required — Departure date in format "yyyy-mm-ddThh:mm" (needs to be earlier than "arr_date_utc")
  - `arr_date_utc` string, date-time, required — Arrival date in format "yyyy-mm-ddThh:mm"
  - `comment` string, nullable — Commentary about flight record (should be less than 100 symbols)
  - `dep_airport` ScheduleAirport — Airport. For create/update use one of the fields: 'id', 'name', 'iata', 'icao', 'lid'. Fields are case-insensitive.
    - `id` integer, nullable — airport identifier
    - `name` string, nullable — airport name
    - `iata` string, nullable — airport IATA code
    - `icao` string, nullable — airport ICAO code
    - `lid` string, nullable — Local Identifier
    - `slug` string, nullable
    - `city` ScheduleCity, required
      - `id` integer, required
      - `name` string, required
      - `country` ScheduleCountry, required
        - `id` integer, required
        - `name` string, required
        - `iso_alpha2` string, nullable — ISO 3166-1 alpha-2
        - `iso_alpha3` string, nullable — ISO 3166-1 alpha-3
  - `arr_airport` ScheduleAirport — Airport. For create/update use one of the fields: 'id', 'name', 'iata', 'icao', 'lid'. Fields are case-insensitive.
    - `id` integer, nullable — airport identifier
    - `name` string, nullable — airport name
    - `iata` string, nullable — airport IATA code
    - `icao` string, nullable — airport ICAO code
    - `lid` string, nullable — Local Identifier
    - `slug` string, nullable
    - `city` ScheduleCity, required
      - `id` integer, required
      - `name` string, required
      - `country` ScheduleCountry, required
        - `id` integer, required
        - `name` string, required
        - `iso_alpha2` string, nullable — ISO 3166-1 alpha-2
        - `iso_alpha3` string, nullable — ISO 3166-1 alpha-3

## Other responses

- `404`
- `429`

---

[API](https://skmtc.dev/aviapages/apis/aviapages-api-documentation.md) · [All operations](https://skmtc.dev/aviapages/apis/aviapages-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aviapages/aviapages-api-documentation/revisions/c9d946178412/schema)
