Skip to main content
POST
Search live car rental offers
Search live car rental availability. pick_up names exactly one of an airport_code (IATA), a free-text place (resolved server-side, ambiguous text returns candidates to retry with), or geo coordinates (round-trip only). Date-times are branch-local YYYY-MM-DDTHH:MM:SS with no timezone. Omit drop_off to return the car to the pick-up branch, setting drop_off_date_time. Each offer’s offer_id is a trip item token: pass it verbatim to POST /v1/trip as trip_item_token to add the rental to a cart, then check out as normal. price.pay_now is the only amount Jinko charges, due_at_desk is collected by the rental desk locally.

Authorizations

X-API-Key
string
header
required

Body

application/json

pick_up names exactly one of airport_code, place or geo, and a drop-off time must come from drop_off.date_time or drop_off_date_time. These rules are enforced at runtime but cannot be expressed in JSON Schema, so they do not appear in required.

pick_up
object
required
driver_age
integer
required

Driver's age at pick-up (18-99). Pricing and availability are age-dependent.

Required range: 18 <= x <= 99
Example:

30

residence_country
string
required

Driver's country of residence, ISO 3166-1 alpha-2. Rates and inclusions vary by residence.

Pattern: ^[A-Za-z]{2}$
Example:

"FR"

drop_off
object

Where the car is returned. Omit for a round trip (return to the pick-up branch) and set drop_off_date_time instead.

drop_off_date_time
string

Drop-off date-time for a round trip, branch-local. Required when drop_off is omitted.

Pattern: ^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}$
Example:

"2026-09-15T10:00:00"

currency
string

ISO 4217 display currency. Defaults to USD.

Required string length: 3
Example:

"EUR"

lang
string

BCP-47 language tag for vehicle and branch text.

Example:

"en-gb"

intent
object

Response

Bookable car rental offers

offers
object[]
currency
string
Example:

"EUR"

resolved_place
object

How a free-text place was interpreted. Echoed so the caller can confirm the resolution.

candidates
object[]

Returned instead of offers when a free-text place is ambiguous. Retry with place set to a candidate's name; when two candidates share a name, qualify it with the city — "City Centre, Lyon".

warnings
object[]