SpotHero

opencollection: 1.0.0
info:
  name: SpotHero Parking API
  version: 2.0.0
request:
  auth:
    type: apikey
    key: X-API-Key
    value: '{{X-API-Key}}'
    placement: header
items:
- info:
    name: Search
    type: folder
  items:
  - info:
      name: Search Parking Locations
      type: http
    http:
      method: GET
      url: https://api.spothero.com/v2/search
      params:
      - name: latitude
        value: ''
        type: query
        description: Latitude of the search center point
      - name: longitude
        value: ''
        type: query
        description: Longitude of the search center point
      - name: address
        value: ''
        type: query
        description: Street address or point of interest name to search near
      - name: starts
        value: ''
        type: query
        description: Parking start time in ISO 8601 format
      - name: ends
        value: ''
        type: query
        description: Parking end time in ISO 8601 format
      - name: radius
        value: ''
        type: query
        description: Search radius in miles (default 0.5)
      - name: vehicle_type
        value: ''
        type: query
        description: Type of vehicle
      - name: limit
        value: ''
        type: query
        description: Maximum number of results to return
      - name: sort
        value: ''
        type: query
        description: Sort order for results
    docs: Search for available parking locations near a given address, coordinates, or point of interest. Returns a list of
      facilities with availability and pricing for the requested time period.
- info:
    name: Facilities
    type: folder
  items:
  - info:
      name: Get Facility
      type: http
    http:
      method: GET
      url: https://api.spothero.com/v2/facilities/:facility_id
      params:
      - name: facility_id
        value: ''
        type: path
        description: Unique identifier for the parking facility
    docs: Retrieve detailed information about a specific parking facility including address, amenities, operating hours, pricing,
      and directions.
- info:
    name: Availability
    type: folder
  items:
  - info:
      name: Get Facility Availability
      type: http
    http:
      method: GET
      url: https://api.spothero.com/v2/facilities/:facility_id/availability
      params:
      - name: facility_id
        value: ''
        type: path
        description: Unique identifier for the parking facility
      - name: starts
        value: ''
        type: query
        description: Start time for availability check in ISO 8601 format
      - name: ends
        value: ''
        type: query
        description: End time for availability check in ISO 8601 format
      - name: vehicle_type
        value: ''
        type: query
        description: Type of vehicle
    docs: Check real-time availability for a specific parking facility during a given time period. Returns current capacity,
      available spaces, and pricing for the requested window.
- info:
    name: Rates
    type: folder
  items:
  - info:
      name: Get Facility Rates
      type: http
    http:
      method: GET
      url: https://api.spothero.com/v2/facilities/:facility_id/rates
      params:
      - name: facility_id
        value: ''
        type: path
        description: Unique identifier for the parking facility
      - name: starts
        value: ''
        type: query
        description: Start time for rate calculation in ISO 8601 format
      - name: ends
        value: ''
        type: query
        description: End time for rate calculation in ISO 8601 format
    docs: Retrieve pricing rates for a specific parking facility. Returns hourly, daily, monthly, and event rates where available.
- info:
    name: Reservations
    type: folder
  items:
  - info:
      name: List Reservations
      type: http
    http:
      method: GET
      url: https://api.spothero.com/v2/reservations
      params:
      - name: status
        value: ''
        type: query
        description: Filter by reservation status
      - name: starts_after
        value: ''
        type: query
        description: Filter reservations starting after this date
      - name: starts_before
        value: ''
        type: query
        description: Filter reservations starting before this date
      - name: facility_id
        value: ''
        type: query
        description: Filter by facility ID
      - name: limit
        value: ''
        type: query
        description: Maximum number of results to return
      - name: offset
        value: ''
        type: query
        description: Number of results to skip for pagination
    docs: Retrieve a list of parking reservations for the authenticated partner account. Supports filtering by status, date
      range, and facility.
  - info:
      name: Create Reservation
      type: http
    http:
      method: POST
      url: https://api.spothero.com/v2/reservations
      body:
        type: json
        data: '{}'
    docs: Create a new parking reservation at a specific facility for a given time period. Returns a confirmation with a booking
      reference and barcode for facility entry.
  - info:
      name: Get Reservation
      type: http
    http:
      method: GET
      url: https://api.spothero.com/v2/reservations/:reservation_id
      params:
      - name: reservation_id
        value: ''
        type: path
        description: Unique identifier for the reservation
    docs: Retrieve details for a specific parking reservation by its ID.
  - info:
      name: Cancel Reservation
      type: http
    http:
      method: DELETE
      url: https://api.spothero.com/v2/reservations/:reservation_id
      params:
      - name: reservation_id
        value: ''
        type: path
        description: Unique identifier for the reservation
    docs: Cancel an existing parking reservation. Cancellation policies and refund eligibility depend on the facility's terms
      and the time of cancellation relative to the reservation start.
bundled: true