> For the complete documentation index, see [llms.txt](https://docs.globalalerting.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globalalerting.com/web-api/itineraries-flights.md).

# Itineraries Flights

## GET /V2/{tenantVarCode}/itineraries/{itineraryId}/flights

> Returns a list of flights for the itinerary

```json
{"openapi":"3.0.4","info":{"title":"GAP REST API Documentation V2","version":"v2"},"tags":[{"name":"Itineraries - Flights"}],"paths":{"/V2/{tenantVarCode}/itineraries/{itineraryId}/flights":{"get":{"tags":["Itineraries - Flights"],"summary":"Returns a list of flights for the itinerary","operationId":"GetFlights","parameters":[{"name":"tenantVarCode","in":"path","description":"Tenant Var Code","required":true,"schema":{"type":"string"}},{"name":"itineraryId","in":"path","description":"Itinerary Id","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Flight"}}},"application/json;IEEE754Compatible=false":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Flight"}}},"application/json;IEEE754Compatible=true":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Flight"}}},"application/xml":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Flight"}}},"text/plain":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Flight"}}},"application/octet-stream":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Flight"}}},"text/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Flight"}}},"text/xml":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Flight"}}},"text/csv":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Flight"}}}}}}}}},"components":{"schemas":{"Flight":{"required":["Destination","FlightNumber","Origin"],"type":"object","properties":{"Id":{"type":"integer","description":"A unique identifier of the hotel","format":"int32"},"FlightNumber":{"minLength":1,"type":"string","description":"Flight number - tail number (e.g., N12345), or an ident (typically an ICAO airline with flight number, e.g., SWA2558)"},"Origin":{"minLength":1,"type":"string","description":"Origin airport"},"Destination":{"minLength":1,"type":"string","description":"Destination airport"},"OriginLatitude":{"type":"number","description":"Origin latitude","format":"double","nullable":true},"OriginLongitude":{"type":"number","description":"Origin longitude","format":"double","nullable":true},"OriginCountryName":{"type":"string","description":"Origin country name","nullable":true},"OriginCountryCode":{"type":"string","description":"Origin two letter country code","nullable":true},"DepartureTimeZoneId":{"type":"string","description":"Departure time zone id","nullable":true},"DepartureTimeLocal":{"type":"string","description":"Departure local time (required if departure time UTC not specified)","format":"date-time","nullable":true},"DepartureTime":{"type":"string","description":"Departure time UTC (required if departure local time not specified)","format":"date-time","nullable":true},"DestinationLatitude":{"type":"number","description":"Destination latitude","format":"double","nullable":true},"DestinationLongitude":{"type":"number","description":"Destination longitude","format":"double","nullable":true},"DestinationCountryName":{"type":"string","description":"Destination country name","nullable":true},"DestinationCountryCode":{"type":"string","description":"Destination two letter country code","nullable":true},"ArrivalTimeZoneId":{"type":"string","description":"Arrival time zone id","nullable":true},"ArrivalTimeLocal":{"type":"string","description":"Arrival local time (required if arrival time UTC not specified)","format":"date-time","nullable":true},"ArrivalTime":{"type":"string","description":"Arrival time UTC (required if arrival local time not specified)","format":"date-time","nullable":true}},"additionalProperties":false}}}}
```

## POST /V2/{tenantVarCode}/itineraries/{itineraryId}/flights

> Creates a new flight

```json
{"openapi":"3.0.4","info":{"title":"GAP REST API Documentation V2","version":"v2"},"tags":[{"name":"Itineraries - Flights"}],"paths":{"/V2/{tenantVarCode}/itineraries/{itineraryId}/flights":{"post":{"tags":["Itineraries - Flights"],"summary":"Creates a new flight","operationId":"PostFlight","parameters":[{"name":"tenantVarCode","in":"path","description":"Tenant Var Code","required":true,"schema":{"type":"string"}},{"name":"itineraryId","in":"path","description":"Itinerary Id","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"description":"Flight","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/json;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/json;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Flight"}},"text/plain":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/Flight"}},"text/json":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/Flight"}},"text/xml":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/*+xml":{"schema":{"$ref":"#/components/schemas/Flight"}}}},"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"Flight":{"required":["Destination","FlightNumber","Origin"],"type":"object","properties":{"Id":{"type":"integer","description":"A unique identifier of the hotel","format":"int32"},"FlightNumber":{"minLength":1,"type":"string","description":"Flight number - tail number (e.g., N12345), or an ident (typically an ICAO airline with flight number, e.g., SWA2558)"},"Origin":{"minLength":1,"type":"string","description":"Origin airport"},"Destination":{"minLength":1,"type":"string","description":"Destination airport"},"OriginLatitude":{"type":"number","description":"Origin latitude","format":"double","nullable":true},"OriginLongitude":{"type":"number","description":"Origin longitude","format":"double","nullable":true},"OriginCountryName":{"type":"string","description":"Origin country name","nullable":true},"OriginCountryCode":{"type":"string","description":"Origin two letter country code","nullable":true},"DepartureTimeZoneId":{"type":"string","description":"Departure time zone id","nullable":true},"DepartureTimeLocal":{"type":"string","description":"Departure local time (required if departure time UTC not specified)","format":"date-time","nullable":true},"DepartureTime":{"type":"string","description":"Departure time UTC (required if departure local time not specified)","format":"date-time","nullable":true},"DestinationLatitude":{"type":"number","description":"Destination latitude","format":"double","nullable":true},"DestinationLongitude":{"type":"number","description":"Destination longitude","format":"double","nullable":true},"DestinationCountryName":{"type":"string","description":"Destination country name","nullable":true},"DestinationCountryCode":{"type":"string","description":"Destination two letter country code","nullable":true},"ArrivalTimeZoneId":{"type":"string","description":"Arrival time zone id","nullable":true},"ArrivalTimeLocal":{"type":"string","description":"Arrival local time (required if arrival time UTC not specified)","format":"date-time","nullable":true},"ArrivalTime":{"type":"string","description":"Arrival time UTC (required if arrival local time not specified)","format":"date-time","nullable":true}},"additionalProperties":false}}}}
```

## GET /V2/{tenantVarCode}/itineraries/{itineraryId}/flights/{flightId}

> Returns a specific flight

```json
{"openapi":"3.0.4","info":{"title":"GAP REST API Documentation V2","version":"v2"},"tags":[{"name":"Itineraries - Flights"}],"paths":{"/V2/{tenantVarCode}/itineraries/{itineraryId}/flights/{flightId}":{"get":{"tags":["Itineraries - Flights"],"summary":"Returns a specific flight","operationId":"GetFlight","parameters":[{"name":"tenantVarCode","in":"path","description":"Tenant Var Code","required":true,"schema":{"type":"string"}},{"name":"itineraryId","in":"path","description":"Itinerary Id","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"flightId","in":"path","description":"Flight Id","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/json;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/json;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Flight"}},"text/plain":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/octet-stream":{"schema":{"$ref":"#/components/schemas/Flight"}},"text/json":{"schema":{"$ref":"#/components/schemas/Flight"}},"text/xml":{"schema":{"$ref":"#/components/schemas/Flight"}}}}}}}},"components":{"schemas":{"Flight":{"required":["Destination","FlightNumber","Origin"],"type":"object","properties":{"Id":{"type":"integer","description":"A unique identifier of the hotel","format":"int32"},"FlightNumber":{"minLength":1,"type":"string","description":"Flight number - tail number (e.g., N12345), or an ident (typically an ICAO airline with flight number, e.g., SWA2558)"},"Origin":{"minLength":1,"type":"string","description":"Origin airport"},"Destination":{"minLength":1,"type":"string","description":"Destination airport"},"OriginLatitude":{"type":"number","description":"Origin latitude","format":"double","nullable":true},"OriginLongitude":{"type":"number","description":"Origin longitude","format":"double","nullable":true},"OriginCountryName":{"type":"string","description":"Origin country name","nullable":true},"OriginCountryCode":{"type":"string","description":"Origin two letter country code","nullable":true},"DepartureTimeZoneId":{"type":"string","description":"Departure time zone id","nullable":true},"DepartureTimeLocal":{"type":"string","description":"Departure local time (required if departure time UTC not specified)","format":"date-time","nullable":true},"DepartureTime":{"type":"string","description":"Departure time UTC (required if departure local time not specified)","format":"date-time","nullable":true},"DestinationLatitude":{"type":"number","description":"Destination latitude","format":"double","nullable":true},"DestinationLongitude":{"type":"number","description":"Destination longitude","format":"double","nullable":true},"DestinationCountryName":{"type":"string","description":"Destination country name","nullable":true},"DestinationCountryCode":{"type":"string","description":"Destination two letter country code","nullable":true},"ArrivalTimeZoneId":{"type":"string","description":"Arrival time zone id","nullable":true},"ArrivalTimeLocal":{"type":"string","description":"Arrival local time (required if arrival time UTC not specified)","format":"date-time","nullable":true},"ArrivalTime":{"type":"string","description":"Arrival time UTC (required if arrival local time not specified)","format":"date-time","nullable":true}},"additionalProperties":false}}}}
```

## PUT /V2/{tenantVarCode}/itineraries/{itineraryId}/flights/{flightId}

> Updates an existing flight

```json
{"openapi":"3.0.4","info":{"title":"GAP REST API Documentation V2","version":"v2"},"tags":[{"name":"Itineraries - Flights"}],"paths":{"/V2/{tenantVarCode}/itineraries/{itineraryId}/flights/{flightId}":{"put":{"tags":["Itineraries - Flights"],"summary":"Updates an existing flight","operationId":"PutFlight","parameters":[{"name":"tenantVarCode","in":"path","description":"Tenant Var Code","required":true,"schema":{"type":"string"}},{"name":"itineraryId","in":"path","description":"Itinerary Id","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"flightId","in":"path","description":"Flight Id","required":true,"schema":{"type":"integer","format":"int32"}}],"requestBody":{"description":"Flight","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/json;IEEE754Compatible=false":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/json;IEEE754Compatible=true":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/xml":{"schema":{"$ref":"#/components/schemas/Flight"}},"text/plain":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/json-patch+json":{"schema":{"$ref":"#/components/schemas/Flight"}},"text/json":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/*+json":{"schema":{"$ref":"#/components/schemas/Flight"}},"text/xml":{"schema":{"$ref":"#/components/schemas/Flight"}},"application/*+xml":{"schema":{"$ref":"#/components/schemas/Flight"}}}},"responses":{"200":{"description":"OK"}}}}},"components":{"schemas":{"Flight":{"required":["Destination","FlightNumber","Origin"],"type":"object","properties":{"Id":{"type":"integer","description":"A unique identifier of the hotel","format":"int32"},"FlightNumber":{"minLength":1,"type":"string","description":"Flight number - tail number (e.g., N12345), or an ident (typically an ICAO airline with flight number, e.g., SWA2558)"},"Origin":{"minLength":1,"type":"string","description":"Origin airport"},"Destination":{"minLength":1,"type":"string","description":"Destination airport"},"OriginLatitude":{"type":"number","description":"Origin latitude","format":"double","nullable":true},"OriginLongitude":{"type":"number","description":"Origin longitude","format":"double","nullable":true},"OriginCountryName":{"type":"string","description":"Origin country name","nullable":true},"OriginCountryCode":{"type":"string","description":"Origin two letter country code","nullable":true},"DepartureTimeZoneId":{"type":"string","description":"Departure time zone id","nullable":true},"DepartureTimeLocal":{"type":"string","description":"Departure local time (required if departure time UTC not specified)","format":"date-time","nullable":true},"DepartureTime":{"type":"string","description":"Departure time UTC (required if departure local time not specified)","format":"date-time","nullable":true},"DestinationLatitude":{"type":"number","description":"Destination latitude","format":"double","nullable":true},"DestinationLongitude":{"type":"number","description":"Destination longitude","format":"double","nullable":true},"DestinationCountryName":{"type":"string","description":"Destination country name","nullable":true},"DestinationCountryCode":{"type":"string","description":"Destination two letter country code","nullable":true},"ArrivalTimeZoneId":{"type":"string","description":"Arrival time zone id","nullable":true},"ArrivalTimeLocal":{"type":"string","description":"Arrival local time (required if arrival time UTC not specified)","format":"date-time","nullable":true},"ArrivalTime":{"type":"string","description":"Arrival time UTC (required if arrival local time not specified)","format":"date-time","nullable":true}},"additionalProperties":false}}}}
```

## DELETE /V2/{tenantVarCode}/itineraries/{itineraryId}/flights/{flightId}

> Deletes a specific flight

```json
{"openapi":"3.0.4","info":{"title":"GAP REST API Documentation V2","version":"v2"},"tags":[{"name":"Itineraries - Flights"}],"paths":{"/V2/{tenantVarCode}/itineraries/{itineraryId}/flights/{flightId}":{"delete":{"tags":["Itineraries - Flights"],"summary":"Deletes a specific flight","parameters":[{"name":"tenantVarCode","in":"path","description":"Tenant Var Code","required":true,"schema":{"type":"string"}},{"name":"itineraryId","in":"path","description":"Itinerary Id","required":true,"schema":{"type":"integer","format":"int32"}},{"name":"flightId","in":"path","description":"Flight Id","required":true,"schema":{"type":"integer","format":"int32"}}],"responses":{"200":{"description":"OK"}}}}}}
```