# Depots

Retrieve a paginated list of car rental depots. Supports incremental updates via the last_modified filter.

Endpoint: POST /cars/depots
Version: 3.2-Beta
Security: BearerAuth

## Header parameters:

  - `X-Affiliate-Id` (integer, required)
    Include here your Affiliate identifier number

## Request fields (application/json):

  - `last_modified` (string)
    Returns depots modified after the specified timestamp (exclusive).
    Example: "2026-03-01T11:05:00+00:00"

  - `maximum_results` (integer)
    The maximum number of results to return.

  - `languages` (array)
    List of language codes to return translated fields. If a translation is unavailable, the default language (en-gb) is returned.
    Example: ["en-us"]

  - `page` (string)
    Pagination token used to retrieve the next page of results. Obtained from next_page.

## Response 200 fields (application/json):

  - `request_id` (string)
    Uniquely identifies the request. Please provide this identifier when contacting support.

  - `data` (array)

  - `data.id` (integer)
    Unique depot's ID.

  - `data.contact` (object)
    Contact information of the depot. Returns null when unavailable.

  - `data.contact.email` (string,null)
    Email address of the depot. Returns null when unavailable.
    Example: "depot@test.booking.com"

  - `data.contact.telephone` (string,null)
    Telephone number of the depot. Returns null when unavailable.
    Example: "+31882847620"

  - `data.city` (integer)
    Unique identifier of the city. You can see the full list of city IDs calling /common/locations/cities.

  - `data.dropoff` (object,null)
    Drop-off information for the depot.

  - `data.dropoff.instructions` (object)
    Translated pickup or drop-off instructions.

  - `data.dropoff.instructions.^[a-z]{2}(-[a-z]{2})$` (string,null)
    The content localised in this language.

  - `data.dropoff.working_hours` (object)
    Depot working hours.

  - `data.dropoff.working_hours.^(monday|tuesday|wednesday|thursday|friday|saturday|sunday)$` (array)
    Working hours for the day.

  - `data.dropoff.working_hours.^(monday|tuesday|wednesday|thursday|friday|saturday|sunday)$.closing_time` (string)
    Depot closing time
    Example: "21:00:00"

  - `data.dropoff.working_hours.^(monday|tuesday|wednesday|thursday|friday|saturday|sunday)$.opening_time` (string)
    Depot opening time.
    Example: "07:00:00"

  - `data.location` (object)
    Depot location information.

  - `data.location.address` (string,null)
    Depot address information.
    Example: "5 Aankomstpassage"

  - `data.location.airport` (string,null)
    Airport IATA code.
    Example: "AMS"

  - `data.location.depot_location_type` (string,null)
    Specifies where the depot is located (for example, inside the terminal, at a train station, or downtown). Returns null when not defined.
    Enum: "in_terminal", "car_rental_centre", "outside_terminal", "airport_hotel", "shuttle_bus", "meet_greet", "trainstation", "downtown"

  - `data.location.coordinates` (object)

  - `data.location.coordinates.latitude` (number)

  - `data.location.coordinates.longitude` (number)

  - `data.location.country` (string)
    A two-letter code that uniquely identifies a country. This code is defined by the ISO 3166-1 alpha-2 standard (ISO2) as described here: https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2. The full list can be obtained by calling common/locations/countries.

  - `data.location.name` (object)
    Translated depot name.
    Example: {"en-gb":"Amsterdam Airport Schiphol - Terminal 3"}

  - `data.location.name.^[a-z]{2}(-[a-z]{2})$` (string,null)
    The content localised in this language.

  - `data.location.post_code` (string,null)
    Depot post code
    Example: "1118 AX"

  - `data.pickup` (object,null)
    Pickup information for the depot.

  - `data.pickup.instructions` (object)
    Translated pickup or drop-off instructions.

  - `data.pickup.instructions.^[a-z]{2}(-[a-z]{2})$` (string,null)
    The content localised in this language.

  - `data.pickup.working_hours` (object)
    Depot working hours.

  - `data.pickup.working_hours.^(monday|tuesday|wednesday|thursday|friday|saturday|sunday)$` (array)
    Working hours for the day.

  - `data.pickup.working_hours.^(monday|tuesday|wednesday|thursday|friday|saturday|sunday)$.closing_time` (string)
    Depot closing time
    Example: "21:00:00"

  - `data.pickup.working_hours.^(monday|tuesday|wednesday|thursday|friday|saturday|sunday)$.opening_time` (string)
    Depot opening time.
    Example: "07:00:00"

  - `data.services` (array)
    List of services provided by the depot.
    Enum: "shuttle", "meet_greet", "unknown"

  - `data.supplier` (integer)
    Unique identifier of the vehicle supplier. You can see the full list of supplier IDs calling /cars/suppliers.

  - `data.ratings` (object,null)
    Number of reviews and average score for the depot.

  - `data.ratings.number_of_reviews` (integer)
    Number of validated reviews for the depot.

  - `data.ratings.score` (number)
    Current review score of the depot, in the range 1.0 to 10.0.

  - `metadata` (object)
    Metadata about the request.

  - `metadata.next_page` (string,null)
    Indicates that more results are available. Pass this token to the page parameter to retrieve the next page of results.

## Response 400 fields (application/json):

  - `request_id` (string, required)
    Uniquely identifies the request. Please provide this identifier when contacting support.

  - `errors` (array, required)

  - `errors.id` (string, required)

  - `errors.message` (string, required)

## Response 500 fields (application/json):

  - `request_id` (string, required)
    Uniquely identifies the request. Please provide this identifier when contacting support.

  - `errors` (array, required)

  - `errors.id` (string, required)

  - `errors.message` (string, required)