---
title: "Suggest pickup time"
method: POST
path: "/quotes/suggest-pickup-time"
tags: ["Quotes"]
---

# Suggest pickup time

`POST /quotes/suggest-pickup-time`

## Request

- Base URL: `https://warpdrive.staging.transferz.com/partners`
- URL: `https://warpdrive.staging.transferz.com/partners/quotes/suggest-pickup-time`
- Auth: API key in header `X-API-Key`

Suggests a pickup time based on flight arrival or departure to be used in a subsequent quote request

## Headers

- `X-Request-ID` unknown

## Request body

- SuggestedPickupTimeRequestDto
  - `origin` LocationInputDto, required
    - `address` LocationAddressDto
      - `addressSearchPhrase` string, required
      - `countryCode` string
    - `coordinate` CoordinateDto
      - `lat` number, double, required
      - `lng` number, double, required
    - `transferzLocationId` integer
    - `hereId` string
    - `googlePlaceId` string
    - `tomTomId` string
    - `iataCode` string
    - `icaoCode` string
    - `giataId` string
    - `ttiCode` string
  - `destination` LocationInputDto, required
    - `address` LocationAddressDto
      - `addressSearchPhrase` string, required
      - `countryCode` string
    - `coordinate` CoordinateDto
      - `lat` number, double, required
      - `lng` number, double, required
    - `transferzLocationId` integer
    - `hereId` string
    - `googlePlaceId` string
    - `tomTomId` string
    - `iataCode` string
    - `icaoCode` string
    - `giataId` string
    - `ttiCode` string
  - `departureOrArrivalTime` string, date-time, required
  - `travelType` 'DOMESTIC' | 'INTERNATIONAL'
  - `onlyCarryOnLuggage` boolean
  - `roundToNearestMinutes` integer
  - `flightNumber` string

## Response `200`

OK

- SuggestedPickupTimeResponseDto
  - `directionality` 'DEPARTURE' | 'ARRIVAL'
  - `suggestedPickupTime` string, date-time
  - `distanceInMeters` integer
  - `durationInMinutes` integer
  - `bufferTime` integer

---

[API](https://skmtc.dev/transferz/apis/partners-warp-drive-api.md) - [All operations](https://skmtc.dev/transferz/apis/partners-warp-drive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/transferz/apis/partners-warp-drive-api/revisions/6b1afe5272e7?raw)