Live car rental availability between a pick-up and a drop-off place, priced and bookable
Find a rental car for a trip and get bookable, priced offers. Each result flattens one vehicle x rate package x branch pair into an offer whose trip_item_token is what trip(add_item) takes: add it to a trip and check out like any other product. Places are named the way a traveler names them, an IATA airport code, free text, or coordinates, never a provider id. Live pricing, so each call reaches the supplier.
Tool description (what the LLM sees)
Search live car rental availability and return bookable offers. Pass each offer's trip_item_token verbatim to trip(add_item) as trip_item_token to put the rental in a trip, then checkout as normal. There is NO car-specific booking tool.WHEN TO USE THIS TOOL:- The user wants to rent a car / hire a car / needs a vehicle between two dates.- You already know the pick-up place, the pick-up and return date-times, the driver's age, and the driver's country of residence. driver_age and residence_country are REQUIRED and both change the price, ask for them, never guess.NAMING THE PLACE (exactly one of three, per end):- airport_code, a 3-letter IATA code ("LYS"). Prefer this whenever the user named an airport; it needs no resolution step.- place, free text in any language ("lyon part dieu", "Köln Hbf", "Eiffel Tower", an address). Resolved server-side to the rental airport, station or whole city it names, or searched around its position for a landmark or address. resolved_place says what was searched, tell the user, and alternatives lists other places the text may have meant ("Portland, USA Maine" for "Portland"); offer them when the user may have meant one. A region ("Florida"), or text that cannot be pinned down, comes back with status "ambiguous_place" and a candidates list INSTEAD of offers. Put the candidates to the user and retry with the chosen candidate's place, never auto-pick one.- geo, {latitude, longitude, range} for "near me"; range is in metres. Works at either end, including a one-way.Provider ids (location, city, branch, supplier) are not accepted on this surface.DATE-TIMES: branch-local "YYYY-MM-DDTHH:MM:SS" with NO timezone. A "Z" or an offset is rejected, the rental desk works in its own local time. Responses carry each branch's IANA time_zone, which is the only way to turn a local time into an instant.ONE-WAY vs ROUND TRIP: omit drop_off and set drop_off_date_time to return the car to the pick-up branch. For a one-way rental, send drop_off with its own place and date_time.RESPONSE: resolved_place (with source "catalog" or "geocoder" for free text), alternatives (each with the place to search it with), warnings (place_widened: nothing near a landmark had offers, so the nearest airport or city was searched), and offers[], each with trip_item_token ("car_…"), expires_at (~75 minutes, after that, search again), on_request (the supplier confirms manually, so booking settles asynchronously), price, vehicle, package, and pick_up/drop_off branches. total_found / offers_shown / offers_omitted declare any truncation; when offers were dropped, narrow the search rather than paging.RENTAL COMPANY: package.supplier_name is the rental company the customer physically collects the car from, Avis, Hertz, Europcar, Sixt. Surface it with every offer you present: it is one of the things travelers decide on, and two otherwise identical offers are often different companies at different desks. Do not confuse it with vehicle.name (the car model, "or similar" unless model_guaranteed) or package.name (the rate plan, e.g. "Fully Inclusive").MONEY: price.pay_now is the ONLY amount Jinko ever charges. due_at_desk is collected by the rental desk and is display-only, deposit is a card hold, estimated_total is the supplier's FX-movable estimate. Never sum them into a total.IMPORTANT:- An EMPTY cancellation_fees list means the supplier published no schedule. That is UNKNOWN, never "free cancellation". A coverage's excess of null means "not stated", not "no excess".- requires_flight_number on a branch is what the rental DESK asks for, not a booking requirement: EVERY branch is bookable either way, on both "always" and "out_of_hours_pickup". Pass the traveller's flight as contact.flight_number on trip(upsert_travelers) when they have one, the rental company can then hold the car for a delayed flight, and omit it otherwise. Checkout is never refused for want of it, so do not steer a traveller to a different branch over this field, and do not invent a flight number for someone who is not flying.- Booking a car also needs the booking contact's honorific, pass contact.title (e.g. "mr", "ms", "mx") on trip(upsert_travelers). It is matched against the supplier's own title vocabulary, so an unusual value may not resolve. Checkout refuses a trip with a car and no title, before any card is charged.
Parameters
Name
Type
Required
Description
pick_up
object
Yes
Where and when the car is collected. The place is exactly one of airport_code, place or geo.
pick_up.date_time
string
Yes
Pick-up date-time, BRANCH-LOCAL and zone-less: “2026-09-12T10:00:00”. Never send a “Z” or an offset.
pick_up.airport_code
string
No
IATA airport code (e.g. “LYS”). The primary path, it needs no resolution hop, so prefer it whenever the user named an airport.
pick_up.place
string
No
Free-text location in any language, a city, station, airport, landmark or address (“lyon part dieu”, “Köln Hbf”, “Eiffel Tower”). Resolved server-side to the rental airport, station or whole city it names, or searched around its position; resolved_place says how, and alternatives lists other places it may have meant. A region, or text that cannot be pinned down, returns candidates INSTEAD of offers: put those to the user and retry with the chosen candidate’s place. Never auto-pick a candidate.
pick_up.geo
object
No
Coordinates plus a radius, for “near me” searches. Works at either end, including a one-way: the other end may be an airport_code, a place or another geo.
pick_up.geo.latitude
number
Yes
Latitude in decimal degrees.
pick_up.geo.longitude
number
Yes
Longitude in decimal degrees.
pick_up.geo.range
integer
Yes
Search radius around the coordinates, in metres (minimum 50). The provider returns the 30 closest branches.
drop_off
object
No
Where the car is returned, for a one-way rental. OMIT for a round trip (returned to the pick-up branch) and set drop_off_date_time instead.
drop_off.date_time
string
No
Drop-off date-time, branch-local. May instead be given as the top-level drop_off_date_time; set only one.
drop_off.airport_code
unknown
No
drop_off.place
unknown
No
drop_off.geo
unknown
No
drop_off_date_time
string
No
Return date-time when drop_off is omitted, branch-local. A rental with no end has no price, so one of this or drop_off.date_time is REQUIRED.
driver_age
integer
Yes
The driver’s age at pick-up (18-99). Price-affecting and REQUIRED, ask the user rather than guessing. It is baked into the rate and is never asked again at booking.
residence_country
string
Yes
The driver’s country of residence, ISO 3166-1 alpha-2. REQUIRED: it changes both the price and which suppliers will rent at all.
currency
string
No
ISO 4217 display currency (e.g. “EUR”). Defaults to the caller’s country/locale, else USD, so a mixed trip stays single-currency.
lang
string
No
BCP-47 language tag for provider text (package names, fuel policy), e.g. “en-gb”.
user_intent
string
No
The end user’s current request in their own words, e.g. “help me with my travel plans”. Pass it as-is when short; otherwise condense the goal and constraints into 1-2 sentences. Strip personal identifiers (names, emails, phone numbers, addresses, payment details), replace them with placeholders like “[name]”. Optional. Jinko uses it to understand demand, and hotel_search uses it to rank hotel results against what the user asked for (e.g. “quiet, with a gym, near Times Square”), so keep the user’s stated preferences in it.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Jinko Platform","description":"Connect your AI agent to flights, hotels, car rentals, and bookings through MCP, REST API, TypeScript SDK, or CLI.","colors":{"primary":"#FF6363","light":"#FF807C","dark":"#BA4B4A"},"logo":{"light":"https://mintcdn.com/jinko/tLgBpae546SdRBMu/logo/jinko-logo.png?fit=max\u0026auto=format\u0026n=tLgBpae546SdRBMu\u0026q=85\u0026s=8cf307169eba8c087816a44a41447566","dark":"https://mintcdn.com/jinko/tLgBpae546SdRBMu/logo/jinko-logo.png?fit=max\u0026auto=format\u0026n=tLgBpae546SdRBMu\u0026q=85\u0026s=8cf307169eba8c087816a44a41447566"},"favicon":"https://mintcdn.com/jinko/tLgBpae546SdRBMu/favicon.png?fit=max\u0026auto=format\u0026n=tLgBpae546SdRBMu\u0026q=85\u0026s=9feee2aba3d7cc147bcacb6d4d2ccdb7","navbar":{"links":[{"href":"https://dashboard.gojinko.com","label":"Dashboard"}],"primary":{"type":"button","label":"Get API Key","href":"https://dashboard.gojinko.com/developers/keys"}},"footer":{"socials":{"website":"https://gojinko.com"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"jinko","hasAudioNarration":false,"actualSubdomain":"jinko","customDomains":["docs.gojinko.com"],"gitSource":{"type":"github","owner":"jinkoso","repo":"jinko-dev-platform","deployBranch":"docs-prod","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6b0032b9baa97067db10a4c2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API reference","count":62},{"language":"default","tag":"CLI","count":47},{"language":"default","tag":"Documentation","count":41},{"language":"default","tag":"Flights","count":40},{"language":"default","tag":"MCP","count":22},{"language":"default","tag":"Manage","count":20},{"language":"default","tag":"Trip \u0026 Payment","count":19},{"language":"default","tag":"Discovery","count":17},{"language":"default","tag":"Hotels","count":16},{"language":"default","tag":"Travel Demand","count":14}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[]}
{"page":{"pagePath":"tools/car-search","slug":"/tools/car-search","pageMetadata":{"title":"Search Car Rentals","description":"Live car rental availability between a pick-up and a drop-off place, priced and bookable","href":"/tools/car-search"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Live car rental availability between a pick-up and a drop-off place, priced and bookable\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,..._provideComponents(),...props.components},{Accordion,CodeBlock,Heading,Table}=_components;if(!Accordion)_missingMdxReference(`Accordion`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Find a rental car for a trip and get bookable, priced offers. Each result flattens one vehicle x rate package x branch pair into an offer whose trip_item_token is what trip(add_item) takes: add it to a trip and check out like any other product. Places are named the way a traveler names them, an IATA airport code, free text, or coordinates, never a provider id. Live pricing, so each call reaches the supplier.`}),`\n`,_jsx(Accordion,{title:`Tool description (what the LLM sees)`,defaultOpen:false,id:`tool-description-what-the-llm-sees`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`27`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`27`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Search live car rental availability and return bookable offers. Pass each offer's trip_item_token verbatim to trip(add_item) as trip_item_token to put the rental in a trip, then checkout as normal. There is NO car-specific booking tool.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`WHEN TO USE THIS TOOL:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- The user wants to rent a car / hire a car / needs a vehicle between two dates.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- You already know the pick-up place, the pick-up and return date-times, the driver's age, and the driver's country of residence. driver_age and residence_country are REQUIRED and both change the price, ask for them, never guess.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`NAMING THE PLACE (exactly one of three, per end):`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- airport_code, a 3-letter IATA code (\"LYS\"). Prefer this whenever the user named an airport; it needs no resolution step.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- place, free text in any language (\"lyon part dieu\", \"Köln Hbf\", \"Eiffel Tower\", an address). Resolved server-side to the rental airport, station or whole city it names, or searched around its position for a landmark or address. resolved_place says what was searched, tell the user, and alternatives lists other places the text may have meant (\"Portland, USA Maine\" for \"Portland\"); offer them when the user may have meant one. A region (\"Florida\"), or text that cannot be pinned down, comes back with status \"ambiguous_place\" and a candidates list INSTEAD of offers. Put the candidates to the user and retry with the chosen candidate's place, never auto-pick one.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- geo, {latitude, longitude, range} for \"near me\"; range is in metres. Works at either end, including a one-way.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Provider ids (location, city, branch, supplier) are not accepted on this surface.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`DATE-TIMES: branch-local \"YYYY-MM-DDTHH:MM:SS\" with NO timezone. A \"Z\" or an offset is rejected, the rental desk works in its own local time. Responses carry each branch's IANA time_zone, which is the only way to turn a local time into an instant.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`ONE-WAY vs ROUND TRIP: omit drop_off and set drop_off_date_time to return the car to the pick-up branch. For a one-way rental, send drop_off with its own place and date_time.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`RESPONSE: resolved_place (with source \"catalog\" or \"geocoder\" for free text), alternatives (each with the place to search it with), warnings (place_widened: nothing near a landmark had offers, so the nearest airport or city was searched), and offers[], each with trip_item_token (\"car_…\"), expires_at (~75 minutes, after that, search again), on_request (the supplier confirms manually, so booking settles asynchronously), price, vehicle, package, and pick_up/drop_off branches. total_found / offers_shown / offers_omitted declare any truncation; when offers were dropped, narrow the search rather than paging.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`RENTAL COMPANY: package.supplier_name is the rental company the customer physically collects the car from, Avis, Hertz, Europcar, Sixt. Surface it with every offer you present: it is one of the things travelers decide on, and two otherwise identical offers are often different companies at different desks. Do not confuse it with vehicle.name (the car model, \"or similar\" unless model_guaranteed) or package.name (the rate plan, e.g. \"Fully Inclusive\").`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`MONEY: price.pay_now is the ONLY amount Jinko ever charges. due_at_desk is collected by the rental desk and is display-only, deposit is a card hold, estimated_total is the supplier's FX-movable estimate. Never sum them into a total.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`IMPORTANT:`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- An EMPTY cancellation_fees list means the supplier published no schedule. That is UNKNOWN, never \"free cancellation\". A coverage's excess of null means \"not stated\", not \"no excess\".`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- requires_flight_number on a branch is what the rental DESK asks for, not a booking requirement: EVERY branch is bookable either way, on both \"always\" and \"out_of_hours_pickup\". Pass the traveller's flight as contact.flight_number on trip(upsert_travelers) when they have one, the rental company can then hold the car for a delayed flight, and omit it otherwise. Checkout is never refused for want of it, so do not steer a traveller to a different branch over this field, and do not invent a flight number for someone who is not flying.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`- Booking a car also needs the booking contact's honorific, pass contact.title (e.g. \"mr\", \"ms\", \"mx\") on trip(upsert_travelers). It is matched against the supplier's own title vocabulary, so an unusual value may not resolve. Checkout refuses a trip with a car and no title, before any card is charged.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})})}),`\n`,_jsx(Heading,{level:`2`,id:`parameters`,children:`Parameters`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Name`}),_jsx(_components.th,{children:`Type`}),_jsx(_components.th,{children:`Required`}),_jsx(_components.th,{children:`Description`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pick_up`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`object`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Where and when the car is collected. The place is exactly one of airport_code, place or geo.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pick_up.date_time`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Pick-up date-time, BRANCH-LOCAL and zone-less: “2026-09-12T10:00:00”. Never send a “Z” or an offset.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pick_up.airport_code`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`IATA airport code (e.g. “LYS”). The primary path, it needs no resolution hop, so prefer it whenever the user named an airport.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pick_up.place`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Free-text location in any language, a city, station, airport, landmark or address (“lyon part dieu”, “Köln Hbf”, “Eiffel Tower”). Resolved server-side to the rental airport, station or whole city it names, or searched around its position; `,_jsx(_components.code,{children:`resolved_place`}),` says how, and `,_jsx(_components.code,{children:`alternatives`}),` lists other places it may have meant. A region, or text that cannot be pinned down, returns `,_jsx(_components.code,{children:`candidates`}),` INSTEAD of offers: put those to the user and retry with the chosen candidate’s `,_jsx(_components.code,{children:`place`}),`. Never auto-pick a candidate.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pick_up.geo`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`object`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`Coordinates plus a radius, for “near me” searches. Works at either end, including a one-way: the other end may be an airport_code, a place or another geo.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pick_up.geo.latitude`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`number`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Latitude in decimal degrees.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pick_up.geo.longitude`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`number`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Longitude in decimal degrees.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`pick_up.geo.range`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`integer`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`Search radius around the coordinates, in metres (minimum 50). The provider returns the 30 closest branches.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`drop_off`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`object`})}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Where the car is returned, for a one-way rental. OMIT for a round trip (returned to the pick-up branch) and set `,_jsx(_components.code,{children:`drop_off_date_time`}),` instead.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`drop_off.date_time`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Drop-off date-time, branch-local. May instead be given as the top-level `,_jsx(_components.code,{children:`drop_off_date_time`}),`; set only one.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`drop_off.airport_code`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`drop_off.place`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`drop_off.geo`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`unknown`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`drop_off_date_time`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`No`}),_jsxs(_components.td,{children:[`Return date-time when `,_jsx(_components.code,{children:`drop_off`}),` is omitted, branch-local. A rental with no end has no price, so one of this or `,_jsx(_components.code,{children:`drop_off.date_time`}),` is REQUIRED.`]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`driver_age`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`integer`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`The driver’s age at pick-up (18-99). Price-affecting and REQUIRED, ask the user rather than guessing. It is baked into the rate and is never asked again at booking.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`residence_country`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`Yes`}),_jsx(_components.td,{children:`The driver’s country of residence, ISO 3166-1 alpha-2. REQUIRED: it changes both the price and which suppliers will rent at all.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`currency`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`ISO 4217 display currency (e.g. “EUR”). Defaults to the caller’s country/locale, else USD, so a mixed trip stays single-currency.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`lang`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`BCP-47 language tag for provider text (package names, fuel policy), e.g. “en-gb”.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.code,{children:`user_intent`})}),_jsx(_components.td,{children:_jsx(_components.code,{children:`string`})}),_jsx(_components.td,{children:`No`}),_jsx(_components.td,{children:`The end user’s current request in their own words, e.g. “help me with my travel plans”. Pass it as-is when short; otherwise condense the goal and constraints into 1-2 sentences. Strip personal identifiers (names, emails, phone numbers, addresses, payment details), replace them with placeholders like “[name]”. Optional. Jinko uses it to understand demand, and hotel_search uses it to rank hotel results against what the user asked for (e.g. “quiet, with a gym, near Times Square”), so keep the user’s stated preferences in it.`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Search Car Rentals","description":"Live car rental availability between a pick-up and a drop-off place, priced and bookable","href":"/tools/car-search"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Parameters","slug":"parameters","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"jinko","siteName":"Jinko Platform","title":"Search Car Rentals - Jinko Platform","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T07:28:05.625Z","originalFileLocation":"tools/car-search.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Live car rental availability between a pick-up and a drop-off place, priced and bookable\">\u003cmeta data-mint-head name=\"application-name\" content=\"Jinko Platform\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/jinko/ayPHPyX_IPSgwuY0/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/jinko/ayPHPyX_IPSgwuY0/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/jinko/ayPHPyX_IPSgwuY0/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/jinko/ayPHPyX_IPSgwuY0/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/jinko/ayPHPyX_IPSgwuY0/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/jinko/ayPHPyX_IPSgwuY0/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/jinko/ayPHPyX_IPSgwuY0/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/jinko/ayPHPyX_IPSgwuY0/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/jinko/ayPHPyX_IPSgwuY0/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search Car Rentals - Jinko Platform\">\u003cmeta data-mint-head property=\"og:description\" content=\"Live car rental availability between a pick-up and a drop-off place, priced and bookable\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Jinko Platform\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.gojinko.com/tools/car-search\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://jinko.mintlify.site/_mintlify/api/og/v2?division=Cars\u0026amp;title=Search+Car+Rentals\u0026amp;description=Live+car+rental+availability+between+a+pick-up+and+a+drop-off+place%2C+priced+and+bookable\u0026amp;theme=b5a3a3aec565a35b202527ea\u0026amp;signature=4844e95336307eb950a88542ded748ff703f9ab564e6a0f5d2c26106da59e541\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Search Car Rentals - Jinko Platform\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Live car rental availability between a pick-up and a drop-off place, priced and bookable\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://jinko.mintlify.site/_mintlify/api/og/v2?division=Cars\u0026amp;title=Search+Car+Rentals\u0026amp;description=Live+car+rental+availability+between+a+pick-up+and+a+drop-off+place%2C+priced+and+bookable\u0026amp;theme=b5a3a3aec565a35b202527ea\u0026amp;signature=4844e95336307eb950a88542ded748ff703f9ab564e6a0f5d2c26106da59e541\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/jinko/ayPHPyX_IPSgwuY0/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Jinko Platform\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF6363\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.gojinko.com/tools/car-search\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/tools/car-search.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.gojinko.com/#organization\",\"name\":\"Jinko Platform\",\"url\":\"https://docs.gojinko.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/jinko/tLgBpae546SdRBMu/logo/jinko-logo.png?fit=max\u0026auto=format\u0026n=tLgBpae546SdRBMu\u0026q=85\u0026s=8cf307169eba8c087816a44a41447566\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.gojinko.com#website\",\"name\":\"Jinko Platform\",\"url\":\"https://docs.gojinko.com\",\"publisher\":{\"@id\":\"https://docs.gojinko.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.gojinko.com/tools/car-search#webpage\",\"url\":\"https://docs.gojinko.com/tools/car-search\",\"name\":\"Search Car Rentals\",\"description\":\"Live car rental availability between a pick-up and a drop-off place, priced and bookable\",\"dateModified\":\"2026-11-13T07:28:05.625Z\",\"isPartOf\":{\"@id\":\"https://docs.gojinko.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.gojinko.com/tools/car-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.gojinko.com/tools/car-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Jinko Platform\",\"item\":\"https://docs.gojinko.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search Car Rentals\",\"item\":\"https://docs.gojinko.com/tools/car-search\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.gojinko.com/tools/car-search#article\",\"headline\":\"Search Car Rentals\",\"name\":\"Search Car Rentals\",\"description\":\"Live car rental availability between a pick-up and a drop-off place, priced and bookable\",\"url\":\"https://docs.gojinko.com/tools/car-search\",\"mainEntityOfPage\":{\"@id\":\"https://docs.gojinko.com/tools/car-search#webpage\"},\"dateModified\":\"2026-11-13T07:28:05.625Z\",\"publisher\":{\"@id\":\"https://docs.gojinko.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.gojinko.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Jinko Platform\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Jinko Platform\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/tools/car-search.md","siteName":"Jinko Platform","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"MCP","groups":[{"group":"Introduction","pages":[{"title":"Overview","href":"/tools/overview"}]},{"group":"Flights","pages":[{"group":"Discovery","pages":[{"title":"Find Destination","href":"/tools/find-destination"},{"title":"Flight Calendar","href":"/tools/flight-calendar"},{"title":"Find Dates","href":"/tools/find-dates"},{"title":"Price Monitoring","href":"/tools/price-monitoring"},{"title":"Flight Price Advice","href":"/tools/flight-price-advice"}]},{"group":"Search","pages":[{"title":"Flight Search","href":"/tools/flight-search"}]},{"group":"Manage","pages":[{"title":"Flight Refund","href":"/tools/flight-refund"},{"title":"Flight Exchange","href":"/tools/flight-exchange"}]}]},{"group":"Hotels","pages":[{"title":"Hotel Search","href":"/tools/hotel-search"},{"title":"Hotel Details","href":"/tools/hotel-details"},{"title":"Hotel Reviews","href":"/tools/hotel-reviews"},{"title":"Cancel Hotel Booking","description":"Preview a hotel cancellation, then cancel it","href":"/tools/hotel-cancel"}]},{"group":"Cars","pages":[{"title":"Search Car Rentals","href":"/tools/car-search"},{"title":"Cancel Car Rental Booking","description":"Preview the cancellation fee, cancel a car rental, or re-read the latest attempt","href":"/tools/car-cancel"}]},{"group":"Trip \u0026 Payment","pages":[{"title":"Trip","href":"/tools/trip"},{"title":"Checkout Trip","href":"/tools/checkout"},{"title":"Submit Agent Payment","href":"/tools/submit-agent-payment"},{"title":"Get Trip","href":"/tools/get-trip"},{"title":"Get Booking","href":"/tools/get-booking"}]},{"group":"Marketing claim","tag":"Preview","pages":[{"title":"Claim the Best Price Guarantee","href":"/tools/claim-best-price-guarantee"},{"title":"Read a Best Price Guarantee claim","href":"/tools/get-best-price-guarantee"}]}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli/overview"}]},{"tab":"API reference","pages":[{"title":"API reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Search Car Rentals - Jinko Platform","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}