Skip to main content

Find transactional Parkings

POST 
/parkings/search-available-parkings

Finds transactional parkings that match the parameters sent in the body based on coordinates.

⚠️ WARNING: For bookable offers, availability and pricing are confirmed only upon submission of the duration. To expedite the process, avoid including the duration in extensive searches (large radius), as this can lead to longer wait times. Instead, use the lmpid to check availability for individual car parks when the user zooms in or focuses on a single parking area.

Request​

Header Parameters

    x-access-token string

    Authentication header obtained from POST /authenticate that identifies the user making this call.

    Example: NgDvLMpPq.6AgfCvkP.YEWA3ZX
    x-api-user string

    Authentication header obtained from POST /authenticate that identifies the client making this call.

    Example: AbC123DeF456GhI789JkL012
    x-api-key string

    Authentication header obtained from POST /authenticate that identifies the user making this call.

    Example: XyZ456AbC789DeF012GhI345

Body

required

Parkings params

    lat floatrequired

    Geo Latitude where to search for nearby offers

    long floatrequired

    Geo Longitude where to search for nearby offers

    start date-time

    Default value: now

    ISO8601 timestamp when parking starts (Defaults to now)

    duration integer

    Possible values: >= 15 and <= 14400

    Default value: 60

    Parking duration in minutes (Defaults to 60, minimum 15, maximum 14400)

    automated boolean

    Return only offers with automated entrance and billing (defaults to null)

    available boolean

    Return only offers that are available for online booking (defaults to null)

    locale string

    Default value: es

    Translates offer`s messages (like access) to the selected language in ISO2 code.

    providers string

    An array of providers to search

    search_radius_meters integer

    Possible values: >= 10 and <= 5000

    Default value: 600

    Spherical Search radius in meters (Defaults to 600, minimum 10, maximum 5000)

Responses​

OK

Schema
  • Array [
    • name stringrequired
    address stringrequired
    area stringrequired
    country stringrequired

    ISO 2 country code

    region stringrequired
    parkingId stringrequired

    ID of the parking to match

    location objectrequired
    type stringrequired

    Possible values: [Point]

    coordinates number[]required

    Array of coordinates: [longitude, latitude]

    distance numberrequired

    Distance from the search point to the parking

    max_height float

    Maximum height allowed

    is_open_24h boolean

    If the parking is open 24 hours

    schedule_formatted object
    day stringrequired

    Possible values: [Monday, Saturday, Tuesday, Wednesday, Friday, Sunday, Thursday]

    open stringrequired

    Possible values: Value must match regular expression ^\\d{2}:\\d{2}$

    close stringrequired

    Possible values: Value must match regular expression ^\\d{2}:\\d{2}$

    is_open_24h boolean
    has_partTime_schedule boolean
    openPartTime string

    Possible values: Value must match regular expression ^\\d{2}:\\d{2}$

    closePartTime string

    Possible values: Value must match regular expression ^\\d{2}:\\d{2}$

    pointsOfInterest object[]
  • Array [
    • name stringrequired
    distance_mts number
    friendly_distance string
  • ]
    • images string[]
    entrances object[]required
  • Array [
    • latitude numberrequired
    longitude numberrequired
    address stringrequired
  • ]
    • services object[]required
  • Array [
    • name stringrequired

    Possible values: [mobility_reduced, covered_parking, video_surveillance, open_24h, electric_recharge, security, mobile_coverage, toilets, elevator, atm, family_car, city_car, car_wash, bicycles, vending_machine, key_delivery, repair_shop, first_aid, battery_recharge, card_payment, motorcycle, connection_public_transport, cash_payment, amazon_lockers, carsharing, car_rental, locker, car_sharing]

    description stringrequired
  • ]
    • freeSpots number

    Number of available spots in the parking

    offers object[]required
  • Array [
    • provider stringrequired
    lmpPID stringrequired
    PID numberrequired
    name stringrequired
    parkingId stringrequired

    ID of the parking to match

    bookable booleanrequired

    If the parking is available for bookings

    automated booleanrequired

    If the parking has automated access

    cancel_msg string
    access_msg string
    commission_percent numberrequired
    customer_price numberrequired
    rates object[]required
  • Array [
    • time numberrequired
    price numberrequired
    unit stringrequired

    Possible values: [day, hour]

    friendly_name stringrequired
    currency stringrequired

    Possible values: [EUR, CZK, CLP, PLN, RON, SEK, GBP, DKK]

  • ]
    • available booleanrequired

    If the offer is available for booking on the indicated date

    cancelable boolean

    If the booking is cancelable

    cancel_mn number

    Minimum time to cancel the booking before it starts

    offer_time number

    Time valid for the booking

    reason stringrequired

    Possible values: [start_too_early, duration_too_short, parking_closed_upon_arrival, parking_closed_upon_departure, parking_closed, no_available_rates, parking_is_full, parking_not_available, duration_too_long, verificado, no_verificado]

  • ]
  • ]
Loading...