# Request quotes

> Request quotes for a transfer, including return trips and flight lookup.

Section: Partners · Last updated: 2026-11-18

You will get prices for a transfer, one per available vehicle category, so the traveller can choose
one. You need a staging API key (see [Authentication](https://developers.staging.transferz.com/guides/get-started/authentication)), the
pickup and drop-off locations, the local pickup time, and the number of passengers and bags.

## Step 1: Request quotes

Send the route, the time and the party to [Request quotes](https://developers.staging.transferz.com/reference/partners/request-quotes). This example
asks for a ride from Amsterdam Airport Schiphol to a hotel on the Herengracht, for two adults with
two suitcases and one carry-on bag:

**Request:** [`POST /quotes`](https://developers.staging.transferz.com/reference/partners/request-quotes)

```bash title="cURL"
curl --request POST \
  --url 'https://warpdrive.staging.transferz.com/partners/quotes' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_STAGING_API_KEY' \
  --data '{
  "origin": {
    "iataCode": "AMS"
  },
  "destination": {
    "address": {
      "addressSearchPhrase": "Herengracht 182, Amsterdam",
      "countryCode": "NL"
    }
  },
  "pickupDateTime": "2026-12-01T14:30:00",
  "adultPassengers": 2,
  "childPassengers": 0,
  "infantPassengers": 0,
  "checkedLuggage": 2,
  "carryOnLuggage": 1,
  "currencyCode": "EUR"
}'
```

```javascript title="JavaScript"
const response = await fetch("https://warpdrive.staging.transferz.com/partners/quotes", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_STAGING_API_KEY",
  },
  body: JSON.stringify({
    "origin": {
      "iataCode": "AMS"
    },
    "destination": {
      "address": {
        "addressSearchPhrase": "Herengracht 182, Amsterdam",
        "countryCode": "NL"
      }
    },
    "pickupDateTime": "2026-12-01T14:30:00",
    "adultPassengers": 2,
    "childPassengers": 0,
    "infantPassengers": 0,
    "checkedLuggage": 2,
    "carryOnLuggage": 1,
    "currencyCode": "EUR"
  }),
});

const data = await response.json();
console.log(response.status, data);
```

```java title="Java"
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
  public static void main(String[] args) throws Exception {
    String body = """
        {
          "origin": {
            "iataCode": "AMS"
          },
          "destination": {
            "address": {
              "addressSearchPhrase": "Herengracht 182, Amsterdam",
              "countryCode": "NL"
            }
          },
          "pickupDateTime": "2026-12-01T14:30:00",
          "adultPassengers": 2,
          "childPassengers": 0,
          "infantPassengers": 0,
          "checkedLuggage": 2,
          "carryOnLuggage": 1,
          "currencyCode": "EUR"
        }
        """;

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://warpdrive.staging.transferz.com/partners/quotes"))
        .header("Accept", "application/json")
        .header("Content-Type", "application/json")
        .header("X-API-Key", "YOUR_STAGING_API_KEY")
        .method("POST", HttpRequest.BodyPublishers.ofString(body))
        .build();

    HttpResponse<String> response = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.statusCode());
    System.out.println(response.body());
  }
}
```

```csharp title="C#"
using System.Net.Http;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://warpdrive.staging.transferz.com/partners/quotes");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
request.Headers.TryAddWithoutValidation("X-API-Key", "YOUR_STAGING_API_KEY");

var json = """
    {
      "origin": {
        "iataCode": "AMS"
      },
      "destination": {
        "address": {
          "addressSearchPhrase": "Herengracht 182, Amsterdam",
          "countryCode": "NL"
        }
      },
      "pickupDateTime": "2026-12-01T14:30:00",
      "adultPassengers": 2,
      "childPassengers": 0,
      "infantPassengers": 0,
      "checkedLuggage": 2,
      "carryOnLuggage": 1,
      "currencyCode": "EUR"
    }
    """;
request.Content = new StringContent(json, Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

```php title="PHP"
<?php

$body = <<<'JSON'
{
  "origin": {
    "iataCode": "AMS"
  },
  "destination": {
    "address": {
      "addressSearchPhrase": "Herengracht 182, Amsterdam",
      "countryCode": "NL"
    }
  },
  "pickupDateTime": "2026-12-01T14:30:00",
  "adultPassengers": 2,
  "childPassengers": 0,
  "infantPassengers": 0,
  "checkedLuggage": 2,
  "carryOnLuggage": 1,
  "currencyCode": "EUR"
}
JSON;

$ch = curl_init('https://warpdrive.staging.transferz.com/partners/quotes');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Content-Type: application/json',
        'X-API-Key: YOUR_STAGING_API_KEY',
    ],
    CURLOPT_POSTFIELDS => $body,
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

echo $status, PHP_EOL, $response, PHP_EOL;
```

**Response (200):**

```json
{
  "id": 905512,
  "origin": {
    "bookerEnteredAddress": "AMS",
    "resolvedAddress": "Amsterdam Airport Schiphol (AMS), Evert van de Beekstraat 202, 1118 CP Schiphol, Netherlands",
    "latitude": 52.3105,
    "longitude": 4.7683,
    "hub": true,
    "iataCode": "AMS",
    "usedResolutionMethod": "IATA_CODE"
  },
  "destination": {
    "bookerEnteredAddress": "Herengracht 182, Amsterdam",
    "resolvedAddress": "Herengracht 182, 1016 BR Amsterdam, Netherlands",
    "latitude": 52.3738,
    "longitude": 4.8862,
    "hub": false,
    "iataCode": null,
    "usedResolutionMethod": "ADDRESS_PHRASE"
  },
  "quotes": [
    {
      "id": 7731201,
      "vehicleCategory": "SEDAN",
      "vehicleModels": "Toyota Corolla Touring or similar",
      "passengerCapacity": 3,
      "luggageCapacity": 3,
      "price": 57,
      "vat": 4.71,
      "commission": 5.7,
      "currencyCode": "EUR",
      "combinedSeatBasedAddonCapacity": 2,
      "expires": "2026-11-20T10:45:00",
      "availableTravelAddons": [
        { "id": 77312011, "type": "MEET_GREET", "price": 15, "commission": 1.5, "maxAllowed": 1 },
        { "id": 77312012, "type": "CHILD_SEAT", "price": 10, "commission": 1, "maxAllowed": 2 }
      ],
      "includedWaitingTimeInMinutes": 60,
      "freeCancellationUntil": "2026-11-30T14:30:00",
      "instantConfirmation": true,
      "pricePerPassenger": false
    },
    {
      "id": 7731202,
      "vehicleCategory": "MINIVAN",
      "vehicleModels": "Mercedes-Benz V-Class or similar",
      "passengerCapacity": 7,
      "luggageCapacity": 7,
      "price": 79,
      "vat": 6.52,
      "commission": 7.9,
      "currencyCode": "EUR",
      "combinedSeatBasedAddonCapacity": 2,
      "expires": "2026-11-20T10:45:00",
      "availableTravelAddons": [
        { "id": 77312021, "type": "MEET_GREET", "price": 15, "commission": 1.5, "maxAllowed": 1 }
      ],
      "includedWaitingTimeInMinutes": 60,
      "freeCancellationUntil": "2026-11-30T14:30:00",
      "instantConfirmation": true,
      "pricePerPassenger": false
    }
  ]
}
```

What to send:

- **`origin` and `destination`** (required). One of them must be a hub: an airport, port or station.
  Give each location in one way: an `iataCode` for an airport, an `address` with an
  `addressSearchPhrase` (add `countryCode` for better matches), a `coordinate`, or an id such as
  `googlePlaceId`, `giataId` or `transferzLocationId`. The response shows how each location was
  resolved; check `resolvedAddress` before you show the price.
- **`pickupDateTime`** (required): the local time at the pickup location, without an offset. For an
  airport pickup, [suggest a pickup time](https://developers.staging.transferz.com/guides/partners/suggest-a-pickup-time) from the flight.
- **Passengers and luggage**: `adultPassengers`, `childPassengers`, `infantPassengers`,
  `checkedLuggage` and `carryOnLuggage`. Only vehicles with room for them are quoted.
- **Optional filters**: `limitToVehicleCategories` (a list, for example `["SEDAN", "MINIVAN"]`),
  `requireInstantConfirmation` to receive only quotes that are confirmed instantly, `currencyCode`
  for prices in another currency, and `discountCode`. An invalid discount code is ignored; the quotes
  are then returned without discount.
- **`source`**: an optional label for where in your platform the request came from.
- **`partnerId`**: only if your key gives access to more than one partner account.

> **Deprecated field:** `limitToVehicleCategory` (a single value) is deprecated. Use `limitToVehicleCategories`. If you send
> both, the list wins.

## Step 2: Choose a quote

Show the traveller one option per quote. For each, use:

| Field                                                 | Use                                                                             |
| ----------------------------------------------------- | ------------------------------------------------------------------------------- |
| `vehicleCategory`, `vehicleModels`, `vehicleImageUrl` | What kind of car to expect                                                      |
| `passengerCapacity`, `luggageCapacity`                | How many people and bags fit                                                    |
| `price`, `currencyCode`                               | The price; see also `vat`, `commission` and the discount fields                 |
| `pricePerPassenger`                                   | `true` for shared vehicles, which are priced per passenger                      |
| `availableTravelAddons`                               | Extras the traveller can book, each with its own `id`, `price` and `maxAllowed` |
| `instantConfirmation`                                 | Whether the booking is confirmed straight away                                  |
| `freeCancellationUntil`                               | Until when the journey can be cancelled free of charge                          |
| `expires`                                             | Until when you can book this quote                                              |

Keep the quote `id` and, for each add-on the traveller picks, the add-on `id`. Add-on ids belong to
one quote: in the example both quotes offer meet and greet, each with a different id. You send these
ids when you [create the booking](https://developers.staging.transferz.com/guides/partners/create-a-booking).

An empty `quotes` list is a normal answer, not an error: no vehicle is available for this route,
time and party, for example because the pickup is too soon. Tell the traveller that no transfer is
available, or try another time.

On staging, most airports return quotes.

## Step 3: Request quotes for the return journey

A return trip is two journeys in one booking, and each journey needs its own quote. Send a second
quote request with the origin and destination swapped, the same passengers and luggage, and the
pickup time of the return:

**Request:** [`POST /quotes`](https://developers.staging.transferz.com/reference/partners/request-quotes)

```bash title="cURL"
curl --request POST \
  --url 'https://warpdrive.staging.transferz.com/partners/quotes' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_STAGING_API_KEY' \
  --data '{
  "origin": {
    "address": {
      "addressSearchPhrase": "Herengracht 182, Amsterdam",
      "countryCode": "NL"
    }
  },
  "destination": {
    "iataCode": "AMS"
  },
  "pickupDateTime": "2026-12-08T07:30:00",
  "adultPassengers": 2,
  "checkedLuggage": 2,
  "carryOnLuggage": 1,
  "currencyCode": "EUR"
}'
```

```javascript title="JavaScript"
const response = await fetch("https://warpdrive.staging.transferz.com/partners/quotes", {
  method: "POST",
  headers: {
    Accept: "application/json",
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_STAGING_API_KEY",
  },
  body: JSON.stringify({
    "origin": {
      "address": {
        "addressSearchPhrase": "Herengracht 182, Amsterdam",
        "countryCode": "NL"
      }
    },
    "destination": {
      "iataCode": "AMS"
    },
    "pickupDateTime": "2026-12-08T07:30:00",
    "adultPassengers": 2,
    "checkedLuggage": 2,
    "carryOnLuggage": 1,
    "currencyCode": "EUR"
  }),
});

const data = await response.json();
console.log(response.status, data);
```

```java title="Java"
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
  public static void main(String[] args) throws Exception {
    String body = """
        {
          "origin": {
            "address": {
              "addressSearchPhrase": "Herengracht 182, Amsterdam",
              "countryCode": "NL"
            }
          },
          "destination": {
            "iataCode": "AMS"
          },
          "pickupDateTime": "2026-12-08T07:30:00",
          "adultPassengers": 2,
          "checkedLuggage": 2,
          "carryOnLuggage": 1,
          "currencyCode": "EUR"
        }
        """;

    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://warpdrive.staging.transferz.com/partners/quotes"))
        .header("Accept", "application/json")
        .header("Content-Type", "application/json")
        .header("X-API-Key", "YOUR_STAGING_API_KEY")
        .method("POST", HttpRequest.BodyPublishers.ofString(body))
        .build();

    HttpResponse<String> response = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.statusCode());
    System.out.println(response.body());
  }
}
```

```csharp title="C#"
using System.Net.Http;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Post, "https://warpdrive.staging.transferz.com/partners/quotes");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
request.Headers.TryAddWithoutValidation("X-API-Key", "YOUR_STAGING_API_KEY");

var json = """
    {
      "origin": {
        "address": {
          "addressSearchPhrase": "Herengracht 182, Amsterdam",
          "countryCode": "NL"
        }
      },
      "destination": {
        "iataCode": "AMS"
      },
      "pickupDateTime": "2026-12-08T07:30:00",
      "adultPassengers": 2,
      "checkedLuggage": 2,
      "carryOnLuggage": 1,
      "currencyCode": "EUR"
    }
    """;
request.Content = new StringContent(json, Encoding.UTF8, "application/json");

using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

```php title="PHP"
<?php

$body = <<<'JSON'
{
  "origin": {
    "address": {
      "addressSearchPhrase": "Herengracht 182, Amsterdam",
      "countryCode": "NL"
    }
  },
  "destination": {
    "iataCode": "AMS"
  },
  "pickupDateTime": "2026-12-08T07:30:00",
  "adultPassengers": 2,
  "checkedLuggage": 2,
  "carryOnLuggage": 1,
  "currencyCode": "EUR"
}
JSON;

$ch = curl_init('https://warpdrive.staging.transferz.com/partners/quotes');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'Content-Type: application/json',
        'X-API-Key: YOUR_STAGING_API_KEY',
    ],
    CURLOPT_POSTFIELDS => $body,
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

echo $status, PHP_EOL, $response, PHP_EOL;
```

**Response (200):**

```json
{
  "id": 905513,
  "quotes": [
    {
      "id": 7731301,
      "vehicleCategory": "SEDAN",
      "passengerCapacity": 3,
      "luggageCapacity": 3,
      "price": 57,
      "currencyCode": "EUR",
      "expires": "2026-11-20T10:46:00",
      "availableTravelAddons": [],
      "freeCancellationUntil": "2026-12-07T07:30:00",
      "instantConfirmation": true,
      "pricePerPassenger": false
    }
  ]
}
```

Book both quote ids together in one booking. The outbound and the return journey then share one
booking code. Each journey can have its own vehicle category.

## Look up the traveller's flight

Storing the flight number with the booking lets Transferz track the flight. Use these calls to let
the traveller pick their flight, or to check a flight number they typed.

[Search flights](https://developers.staging.transferz.com/reference/partners/search-flights) lists the flights between two airports on a date. Give
an `arrivalDate` (local to the arrival airport) or a `departureDate` (local to the departure
airport), or both:

**Request:** [`GET /flights/search`](https://developers.staging.transferz.com/reference/partners/search-flights)

```bash title="cURL"
curl --request GET \
  --url 'https://warpdrive.staging.transferz.com/partners/flights/search?departureAirportIataCode=LHR&arrivalAirportIataCode=AMS&arrivalDate=2026-12-01' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: YOUR_STAGING_API_KEY'
```

```javascript title="JavaScript"
const response = await fetch("https://warpdrive.staging.transferz.com/partners/flights/search?departureAirportIataCode=LHR&arrivalAirportIataCode=AMS&arrivalDate=2026-12-01", {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "YOUR_STAGING_API_KEY",
  },
});

const data = await response.json();
console.log(response.status, data);
```

```java title="Java"
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
  public static void main(String[] args) throws Exception {
    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://warpdrive.staging.transferz.com/partners/flights/search?departureAirportIataCode=LHR&arrivalAirportIataCode=AMS&arrivalDate=2026-12-01"))
        .header("Accept", "application/json")
        .header("X-API-Key", "YOUR_STAGING_API_KEY")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();

    HttpResponse<String> response = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.statusCode());
    System.out.println(response.body());
  }
}
```

```csharp title="C#"
using System.Net.Http;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://warpdrive.staging.transferz.com/partners/flights/search?departureAirportIataCode=LHR&arrivalAirportIataCode=AMS&arrivalDate=2026-12-01");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
request.Headers.TryAddWithoutValidation("X-API-Key", "YOUR_STAGING_API_KEY");

using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

```php title="PHP"
<?php

$ch = curl_init('https://warpdrive.staging.transferz.com/partners/flights/search?departureAirportIataCode=LHR&arrivalAirportIataCode=AMS&arrivalDate=2026-12-01');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'X-API-Key: YOUR_STAGING_API_KEY',
    ],
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

echo $status, PHP_EOL, $response, PHP_EOL;
```

**Response (200):**

```json
[
  {
    "flightDesignators": [
      { "airlineCode": "TZ", "flightNumber": "1234", "primary": true, "airlineName": "Example Air" }
    ],
    "scheduledDepartureTimeLocal": "2026-12-01T11:15:00",
    "departureAirportIataCode": "LHR",
    "scheduledArrivalTimeLocal": "2026-12-01T13:40:00",
    "arrivalAirportIataCode": "AMS",
    "departureAirportCountryCode": "GB",
    "arrivalAirportCountryCode": "NL"
  }
]
```

Add `airlineIataCode`, for example `KL`, to narrow the list. An empty list means no flights were
found.

[Resolve a flight](https://developers.staging.transferz.com/reference/partners/resolve-flight) checks one flight number. Send `flightDesignator`
in IATA format (such as `TZ1234`) with both the `departureDate` and the `arrivalDate` (each local to
its airport); all three are required. The response is one flight in the same format as above, or
`404` when no such flight exists on those dates.

**Request:** [`GET /flights/resolve`](https://developers.staging.transferz.com/reference/partners/resolve-flight)

```bash title="cURL"
curl --request GET \
  --url 'https://warpdrive.staging.transferz.com/partners/flights/resolve?flightDesignator=TZ1234&departureDate=2026-12-01&arrivalDate=2026-12-01' \
  --header 'Accept: application/json' \
  --header 'X-API-Key: YOUR_STAGING_API_KEY'
```

```javascript title="JavaScript"
const response = await fetch("https://warpdrive.staging.transferz.com/partners/flights/resolve?flightDesignator=TZ1234&departureDate=2026-12-01&arrivalDate=2026-12-01", {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "YOUR_STAGING_API_KEY",
  },
});

const data = await response.json();
console.log(response.status, data);
```

```java title="Java"
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Example {
  public static void main(String[] args) throws Exception {
    HttpRequest request = HttpRequest.newBuilder()
        .uri(URI.create("https://warpdrive.staging.transferz.com/partners/flights/resolve?flightDesignator=TZ1234&departureDate=2026-12-01&arrivalDate=2026-12-01"))
        .header("Accept", "application/json")
        .header("X-API-Key", "YOUR_STAGING_API_KEY")
        .method("GET", HttpRequest.BodyPublishers.noBody())
        .build();

    HttpResponse<String> response = HttpClient.newHttpClient()
        .send(request, HttpResponse.BodyHandlers.ofString());
    System.out.println(response.statusCode());
    System.out.println(response.body());
  }
}
```

```csharp title="C#"
using System.Net.Http;
using System.Text;

using var client = new HttpClient();
using var request = new HttpRequestMessage(HttpMethod.Get, "https://warpdrive.staging.transferz.com/partners/flights/resolve?flightDesignator=TZ1234&departureDate=2026-12-01&arrivalDate=2026-12-01");
request.Headers.TryAddWithoutValidation("Accept", "application/json");
request.Headers.TryAddWithoutValidation("X-API-Key", "YOUR_STAGING_API_KEY");

using var response = await client.SendAsync(request);
Console.WriteLine((int)response.StatusCode);
Console.WriteLine(await response.Content.ReadAsStringAsync());
```

```php title="PHP"
<?php

$ch = curl_init('https://warpdrive.staging.transferz.com/partners/flights/resolve?flightDesignator=TZ1234&departureDate=2026-12-01&arrivalDate=2026-12-01');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Accept: application/json',
        'X-API-Key: YOUR_STAGING_API_KEY',
    ],
]);

$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

echo $status, PHP_EOL, $response, PHP_EOL;
```

**Response (200):**

```json
{
  "flightDesignators": [
    { "airlineCode": "TZ", "flightNumber": "1234", "primary": true, "airlineName": "Example Air" }
  ],
  "scheduledDepartureTimeLocal": "2026-12-01T11:15:00",
  "departureAirportIataCode": "LHR",
  "scheduledArrivalTimeLocal": "2026-12-01T13:40:00",
  "arrivalAirportIataCode": "AMS",
  "departureAirportCountryCode": "GB",
  "arrivalAirportCountryCode": "NL"
}
```

Use `scheduledArrivalTimeLocal` to [suggest a pickup time](https://developers.staging.transferz.com/guides/partners/suggest-a-pickup-time),
and send the flight number as `traveller.flightNumber` when you create the booking.

## Errors

| Problem                                                                                                                                 | Cause                                                              | What to do                                                                                                                          |
| --------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------- |
| `400` with [NO_HUB_SELECTED](https://developers.staging.transferz.com/reference/errors/no-hub-selected)                                 | Neither location is a hub.                                         | Make the origin or the destination an airport, port or station.                                                                     |
| `400` with [LOCATION_NOT_FOUND](https://developers.staging.transferz.com/reference/errors/location-not-found)                           | A location could not be resolved; `field` says which.              | Send a fuller address with `countryCode`, coordinates or an IATA code.                                                              |
| `400` with [ORIGIN_AND_DESTINATION_SAME](https://developers.staging.transferz.com/reference/errors/origin-and-destination-same)         | Both locations resolve to the same place.                          | Send two different locations.                                                                                                       |
| `400` with [NO_VEHICLE_CATEGORIES_AVAILABLE](https://developers.staging.transferz.com/reference/errors/no-vehicle-categories-available) | None of the categories in your filter is enabled for your account. | Remove the filter, or ask Transferz which categories you have.                                                                      |
| `400` with [CURRENCY_CONVERSION_ERROR](https://developers.staging.transferz.com/reference/errors/currency-conversion-error)             | `currencyCode` is not supported.                                   | Use a supported ISO 4217 code, or leave it out.                                                                                     |
| `400` with a `field`, such as `pickupDateTime`                                                                                          | A required field is missing or invalid.                            | Send the field. See [validation errors](https://developers.staging.transferz.com/guides/essentials/errors#validation-partners-api). |
| `200` with an empty `quotes` list                                                                                                       | No vehicle is available.                                           | Show that no transfer is available, or try another time.                                                                            |
| `400` from Search flights                                                                                                               | Neither `arrivalDate` nor `departureDate` was given.               | Send at least one of the two dates.                                                                                                 |
| `404` from Resolve a flight                                                                                                             | No flight with that number on that date.                           | Ask the traveller to check the flight number and date.                                                                              |

## Next steps

- [Suggest a pickup time](https://developers.staging.transferz.com/guides/partners/suggest-a-pickup-time) from the flight.
- [Create a booking](https://developers.staging.transferz.com/guides/partners/create-a-booking) with the chosen quote.

## Related

### Endpoints

- [POST Request quotes](https://developers.staging.transferz.com/reference/partners/request-quotes) (`POST /quotes`)
- [GET Search flights](https://developers.staging.transferz.com/reference/partners/search-flights) (`GET /flights/search`)
- [GET Resolve flight](https://developers.staging.transferz.com/reference/partners/resolve-flight) (`GET /flights/resolve`)
