Cars

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. Pass each offer's trip_item_token verbatim to POST /v1/trip as add_item.trip_item_token to add the rental to a trip, then check out as normal. price.pay_now is the only amount Jinko charges — due_at_desk is collected by the rental desk locally.

post/v1/car_search

Request

  • Base URL
    https://api.gojinko.com
  • URL
    https://api.gojinko.com/v1/car_search
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Request body

drop_off_date_timestring

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

driver_ageinteger required

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

residence_countrystring required

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

currencystring

ISO 4217 display currency. Defaults to USD.

langstring

BCP-47 language tag for vehicle and branch text.

Example request

{
  "pick_up": {
    "airport_code": "LYS",
    "date_time": "2026-09-12T10:00:00"
  },
  "drop_off_date_time": "2026-09-15T10:00:00",
  "driver_age": 30,
  "residence_country": "FR",
  "currency": "EUR"
}

Response

Bookable car rental offers

currencystring

Example response

{
  "offers": [
    {
      "trip_item_token": "car_9f3b2a17c4e8d501",
      "offer_id": "car_9f3b2a17c4e8d501",
      "vehicle": {
        "acriss_code": "CDMR",
        "name": "Honda Accord or similar",
        "category": "compact",
        "type": "sedan",
        "transmission": "manual",
        "seats": "5",
        "big_suitcases": 2,
        "small_suitcases": 1,
        "supplier_code": "D",
        "images": [
          {
            "url": "https://images.example.com/cars/6f2a.jpg"
          }
        ]
      },
      "package": {
        "name": "Fully Inclusive",
        "code": "FI",
        "supplier_name": "Avis",
        "supplier_code": "DEMO_BCN",
        "fuel_policy": "full_to_full",
        "coverages": [
          {
            "name": "Collision Damage Waiver",
            "excess": {
              "value": 41250,
              "currency": "EUR",
              "decimal_places": 2,
              "display": "EUR 412.50"
            },
            "paid_at": "now",
            "price": {
              "value": 41250,
              "currency": "EUR",
              "decimal_places": 2,
              "display": "EUR 412.50"
            }
          }
        ],
        "fees": [
          {
            "name": "One-way fee",
            "paid_at": "local",
            "price": {
              "value": 41250,
              "currency": "EUR",
              "decimal_places": 2,
              "display": "EUR 412.50"
            }
          }
        ]
      },
      "pick_up": {
        "name": "Lyon Saint-Exupery Airport",
        "city": "Lyon",
        "country": "FR",
        "date_time": "2026-09-12T10:00:00",
        "time_zone": "Europe/Paris",
        "requires_flight_number": "never"
      },
      "drop_off": {
        "name": "Lyon Saint-Exupery Airport",
        "city": "Lyon",
        "country": "FR",
        "date_time": "2026-09-12T10:00:00",
        "time_zone": "Europe/Paris",
        "requires_flight_number": "never"
      },
      "price": {
        "pay_now": {
          "value": 41250,
          "currency": "EUR",
          "decimal_places": 2,
          "display": "EUR 412.50"
        },
        "due_at_desk": {
          "value": 41250,
          "currency": "EUR",
          "decimal_places": 2,
          "display": "EUR 412.50"
        },
        "estimated_total": {
          "value": 41250,
          "currency": "EUR",
          "decimal_places": 2,
          "display": "EUR 412.50"
        },
        "deposit": {
          "value": 41250,
          "currency": "EUR",
          "decimal_places": 2,
          "display": "EUR 412.50"
        }
      },
      "driver_age_range": {
        "min": 25,
        "max": 75
      },
      "cancellation_fees": [
        {
          "type": "cancellation",
          "fee": {
            "value": 41250,
            "currency": "EUR",
            "decimal_places": 2,
            "display": "EUR 412.50"
          }
        }
      ],
      "expires_at": "2026-09-12T10:30:00Z"
    }
  ],
  "currency": "EUR",
  "resolved_place": {
    "name": "Lyon City Centre",
    "kind": "airport",
    "city": "Lyon",
    "country": "FR"
  },
  "candidates": [
    {
      "name": "Lyon City Centre",
      "kind": "airport",
      "city": "Lyon",
      "country": "FR"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.