---
title: "Submit a Flight Intent"
method: POST
path: "/flights/{ident}/intents"
tags: ["flights"]
---

# Submit a Flight Intent

`POST /flights/{ident}/intents`

## Request

- Base URL: `https://aeroapi.flightaware.com/aeroapi`
- URL: `https://aeroapi.flightaware.com/aeroapi/flights/{ident}/intents`
- Auth: API key in header `x-apikey`
- TypeScript: <https://skmtc.dev/flightaware/apis/aeroapi/docs/flights/:ident/intents/post.ts> (a function with typed inputs; its response is checked against the schema)

This operation informs FlightAware of an upcoming (or recently
departed) flight. This information is used solely by FlightAware for
improving the accuracy of flight tracking. This method does not
transmit to any ANSP/ATC facility for flight separation or operational
services. Access to this endpoint requires special account
authorization. The FlightAware account must also be subscribed to
FlightAware Global and the specified registration or ident must be on
the Global account.

## Path parameters

- `ident` string, required

## Request body

- object
  - `aircraft_type` string, required: Aircraft type ICAO code.
  - `origin` string, required: Origin airport ICAO code or LID.
  - `destination` string, required: Destination airport ICAO code or LID.
  - `intended_off` string, date-time, required: Intended runway departure time of flight. This must be within 2 hours of the actual departure time or the flight intent will be ignored. Time may not be more than 1 hour in the past or 48 hours in the future.
  - `intended_on` string, date-time, required: Intended runway arrival time of flight.
  - `altitude` integer: Cruising altitude (feet).
  - `airspeed` integer: Cruising airspeed (knots).
  - `route` string: Flight route as a series of space-separate waypoints.

## Response `200`

OK

## Other responses

- `400`: Incorrect parameter(s). Ident may be missing or pages may be < 1. Body may be incomplete. User may lack permissions to post flight intent for this ident. Arrival/departure times, duration, or aircraft type may be invalid.

---

[API](https://skmtc.dev/flightaware/apis/aeroapi.md) - [All operations](https://skmtc.dev/flightaware/apis/aeroapi/llms.txt) - [OpenAPI document](https://skmtc.dev/flightaware/apis/aeroapi/revisions/3023e7a0c54c?raw)