# Request quotes

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

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

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.test.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.test.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.test.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.test.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.test.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.

> **To be confirmed by Transferz:** Which staging routes return quotes is still to be confirmed by Transferz. The Schiphol example may
> return no quotes on staging.

## 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.test.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.

> **To be confirmed by Transferz:** Whether both journeys of a return trip must use the same vehicle category is still to be confirmed
> by Transferz. Until then, offer the categories that appear in both responses.

## 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.test.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.test.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.test.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.test.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.test.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.test.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.test.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.test.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.test.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.test.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.test.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.test.transferz.com/guides/partners/suggest-a-pickup-time) from the flight.
- [Create a booking](https://developers.test.transferz.com/guides/partners/create-a-booking) with the chosen quote.

## Related

### Endpoints

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

### Walk-through steps

- [Get prices](https://developers.test.transferz.com/walkthrough/partner/get-prices)
