Flight Offers Search

amadeus · Company

Company No Auth Free & Open location

Before using this API, we recommend you read our **[Authorization Guide](https://developers.amadeus.com/self-service/apis-docs/guides/authorization)** for more information on how to generate an access token. Please also be aware that our test environment is based on a subset of the production, if you are not returning any results try with big cities/airports like LON (London) or NYC (New-York).

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Return list of Flight Offers based on searching criteria.

Return list of Flight Offers based on searching criteria.

https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers?max=250&adults=1&infants=1&nonStop=false&children=1&maxPrice=1&returnDate=example&travelClass=ECONOMY&currencyCode=example&departureDate=example&originLocationCode=example&excludedAirlineCodes=example&includedAirlineCodes=example&destinationLocationCode=example

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers?max=250&adults=1&infants=1&nonStop=false&children=1&maxPrice=1&returnDate=example&travelClass=ECONOMY&currencyCode=example&departureDate=example&originLocationCode=example&excludedAirlineCodes=example&includedAirlineCodes=example&destinationLocationCode=example"

import requests
params = {
    "max": "250",
    "adults": "1",
    "infants": "1",
    "nonStop": "false",
    "children": "1",
    "maxPrice": "1",
    "returnDate": "example",
    "travelClass": "ECONOMY",
    "currencyCode": "example",
    "departureDate": "example",
    "originLocationCode": "example",
    "excludedAirlineCodes": "example",
    "includedAirlineCodes": "example",
    "destinationLocationCode": "example"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers');
url.searchParams.set('max', '250');
url.searchParams.set('adults', '1');
url.searchParams.set('infants', '1');
url.searchParams.set('nonStop', 'false');
url.searchParams.set('children', '1');
url.searchParams.set('maxPrice', '1');
url.searchParams.set('returnDate', 'example');
url.searchParams.set('travelClass', 'ECONOMY');
url.searchParams.set('currencyCode', 'example');
url.searchParams.set('departureDate', 'example');
url.searchParams.set('originLocationCode', 'example');
url.searchParams.set('excludedAirlineCodes', 'example');
url.searchParams.set('includedAirlineCodes', 'example');
url.searchParams.set('destinationLocationCode', 'example');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers")
	q := baseURL.Query()
	q.Set("max", "250")
	q.Set("adults", "1")
	q.Set("infants", "1")
	q.Set("nonStop", "false")
	q.Set("children", "1")
	q.Set("maxPrice", "1")
	q.Set("returnDate", "example")
	q.Set("travelClass", "ECONOMY")
	q.Set("currencyCode", "example")
	q.Set("departureDate", "example")
	q.Set("originLocationCode", "example")
	q.Set("excludedAirlineCodes", "example")
	q.Set("includedAirlineCodes", "example")
	q.Set("destinationLocationCode", "example")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers")
uri.query = URI.encode_www_form({
  "max" => "250",
  "adults" => "1",
  "infants" => "1",
  "nonStop" => "false",
  "children" => "1",
  "maxPrice" => "1",
  "returnDate" => "example",
  "travelClass" => "ECONOMY",
  "currencyCode" => "example",
  "departureDate" => "example",
  "originLocationCode" => "example",
  "excludedAirlineCodes" => "example",
  "includedAirlineCodes" => "example",
  "destinationLocationCode" => "example"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers?" . http_build_query([
    "max" => "250",
    "adults" => "1",
    "infants" => "1",
    "nonStop" => "false",
    "children" => "1",
    "maxPrice" => "1",
    "returnDate" => "example",
    "travelClass" => "ECONOMY",
    "currencyCode" => "example",
    "departureDate" => "example",
    "originLocationCode" => "example",
    "excludedAirlineCodes" => "example",
    "includedAirlineCodes" => "example",
    "destinationLocationCode" => "example"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

POST Return list of Flight Offers based on posted searching criteria.

Return list of Flight Offers based on posted searching criteria.

https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers

Hover any highlighted part to learn what it does

Headers — extra info sent with the request

X-HTTP-Method-Override

GET

curl -X POST "https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers" \
  -H "X-HTTP-Method-Override: GET"

import requests
headers = {
    "X-HTTP-Method-Override": "GET"
}
response = requests.post(
    "https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers",
    headers=headers,
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers';

const response = await fetch(url, {
  method: 'POST',
  headers: {
    'X-HTTP-Method-Override': 'GET'
  },
}); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers"
	req, _ := http.NewRequest("POST", targetURL, nil)
	req.Header.Set("X-HTTP-Method-Override", "GET")

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Post.new(uri)
req["X-HTTP-Method-Override"] = "GET"

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/amadeus.com/2.2.0/shopping/flight-offers";
$opts = ["http" => [
    "method" => "POST",
    "header" => implode("\r\n", [
        "X-HTTP-Method-Override: GET"
    ]),
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Flight Offers Search?

Flight Offers Search is a Company API. Developers commonly use company APIs for:

enriching CRM records with company firmographics
building lead-generation and prospecting tools
verifying business identity and registration details
monitoring competitors and market intelligence
powering B2B data enrichment pipelines

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Flight Offers Search is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗