# Flight Offers Search API

> Flight Offers Search API on Apizie: 2 endpoints (Return list of Flight Offers based on searching criteria., Return list of Flight Offers based on posted searching criteria.) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/places:amadeus/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `places:amadeus`
- Category: Places
- Status: byok
- Source: https://amadeus.com
- Page: https://apizie.tech/api/places/amadeus
- OpenAPI: https://apizie.tech/api/places/amadeus/openapi.json

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…

## Endpoints

### Return list of Flight Offers based on searching criteria.
`GET https://apizie.tech/v1/places:amadeus/get-flight-offers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| originLocationCode | string | yes | city/airport [IATA code](http://www.iata.org/publications/Pages/code-search.aspx) from which the traveler will depart, e.g. BOS for Boston |
| destinationLocationCode | string | yes | city/airport [IATA code](http://www.iata.org/publications/Pages/code-search.aspx) to which the traveler is going, e.g. PAR for Paris |
| departureDate | string | yes | the date on which the traveler will depart from the origin to go to the destination. Dates are specified in the [ISO… |
| returnDate | string | no | the date on which the traveler will depart from the destination to return to the origin. If this parameter is not specified, only one-way… |
| adults | integer | yes | the number of adult travelers (age 12 or older on date of departure). |
| children | integer | no | the number of child travelers (older than age 2 and younger than age 12 on date of departure) who will each have their own separate seat.… |
| infants | integer | no | the number of infant travelers (whose age is less or equal to 2 on date of departure). Infants travel on the lap of an adult traveler, and… |
| travelClass | string | no | most of the flight time should be spent in a cabin of this quality or higher. The accepted travel class is economy, premium economy,… |
| includedAirlineCodes | string | no | This option ensures that the system will only consider these airlines. This can not be cumulated with parameter excludedAirlineCodes.… |
| excludedAirlineCodes | string | no | This option ensures that the system will ignore these airlines. This can not be cumulated with parameter includedAirlineCodes. Airlines… |
| nonStop | boolean | no | if set to true, the search will find only flights going from the origin to the destination with no stop in between |
| currencyCode | string | no | the preferred currency for the flight offers. Currency is specified in the [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) format, e.g.… |
| maxPrice | integer | no | maximum price per traveler. By default, no limit is applied. If specified, the value should be a positive number with no decimals |
| max | integer | no | maximum number of flight offers to return. If specified, the value should be greater than or equal to 1 |

### Return list of Flight Offers based on posted searching criteria.
`POST https://apizie.tech/v1/places:amadeus/search-flight-offers` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-HTTP-Method-Override | string | yes | the HTTP method to apply |
| body | object | yes | JSON request body |

## Example
```
curl "https://apizie.tech/v1/places:amadeus/get-flight-offers" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Flight Offers Search API?
Create a free Apizie key, then send GET https://apizie.tech/v1/places:amadeus/get-flight-offers with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Flight Offers Search API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Flight Offers Search itself also needs your own key from amadeus.com.

### Can AI agents use the Flight Offers Search API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key places:amadeus.

### What is the status of the Flight Offers Search API?
Needs your own provider key (bring your own key)