Park Graph

Find Park Graph parking lots near a place, nearest first, with spaces left and the current rate. No API key needed. Ask the driver where they're going and work out its latitude and longitude first. Each lot's id is what quote, get_lot and reserve take. The top-level summary is a one-line answer you can quote. An empty list means Park Graph has no lots near that point: say so, and never make up lots.

{
  "type": "object",
  "properties": {
    "lat": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Latitude of where the driver is going, worked out from the place or address they give"
    },
    "lng": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Longitude of where the driver is going"
    },
    "radius_km": {
      "type": "number",
      "minimum": 0.1,
      "maximum": 100,
      "default": 5,
      "description": "How far from that point to look, in km"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10,
      "description": "Most lots to return"
    }
  },
  "required": [
    "lat",
    "lng"
  ],
  "additionalProperties": false
}

Full public details for one lot: address, coordinates, spaces, features, hours, pricing and spaces left right now. No API key needed.

{
  "type": "object",
  "properties": {
    "lot_id": {
      "type": "string",
      "format": "uuid",
      "description": "Lot id from search_lots"
    }
  },
  "required": [
    "lot_id"
  ],
  "additionalProperties": false
}

Price to park at a lot for a number of hours, at the lot's current rate (daily max applied). No API key needed. booking.mode says what comes next: reserve (call reserve to hold a space) or pay_at_qr_page (give the driver booking.pay_url, where they pay and park).

{
  "type": "object",
  "properties": {
    "lot_id": {
      "type": "string",
      "format": "uuid",
      "description": "Lot id from search_lots"
    },
    "duration_hours": {
      "type": "number",
      "minimum": 0.25,
      "maximum": 24,
      "description": "How long the driver will park, in hours. Ask them if they haven't said."
    }
  },
  "required": [
    "lot_id",
    "duration_hours"
  ],
  "additionalProperties": false
}

Hold space at a lot for the driver for a few minutes (POST /api/v1/reserve rules). No API key needed. Ask the driver to confirm before calling it. Lots that take payment at their QR page place no hold: you get status pay_at_qr_page and a pay_url to give the driver. A hold is confirmed with POST /api/v1/reserve/confirm before it expires.

{
  "type": "object",
  "properties": {
    "lot_id": {
      "type": "string",
      "format": "uuid",
      "description": "Lot id from search_lots"
    },
    "intent": {
      "type": "string",
      "minLength": 4,
      "maxLength": 500,
      "description": "What the driver needs, in plain words (optional)"
    },
    "space_count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 1,
      "description": "How many spaces the driver needs"
    },
    "ttl_seconds": {
      "type": "integer",
      "minimum": 30,
      "maximum": 900,
      "default": 180,
      "description": "How long the hold lasts, in seconds"
    },
    "start": {
      "type": "string",
      "format": "date-time",
      "description": "When the driver arrives (ISO 8601), if they said"
    },
    "end": {
      "type": "string",
      "format": "date-time",
      "description": "When the driver leaves (ISO 8601), if they said"
    },
    "vehicle": {
      "type": "object",
      "description": "The driver's vehicle, if they said",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "standard",
            "ev",
            "oversized",
            "motorcycle",
            "rv",
            "av"
          ]
        },
        "plate": {
          "type": "string",
          "minLength": 1,
          "maxLength": 20
        },
        "needs_charger": {
          "type": "boolean"
        },
        "length_meters": {
          "type": "number",
          "exclusiveMinimum": 0,
          "maximum": 20
        }
      }
    },
    "duration_hours": {
      "type": "integer",
      "enum": [
        1,
        2,
        4,
        8
      ],
      "description": "Hours to book. The result's booking_url opens the lot's pay page on this length"
    },
    "plate": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "description": "Plate to pre-fill on the pay page, if the driver said"
    },
    "agent_platform": {
      "type": "string",
      "enum": [
        "chatgpt",
        "claude",
        "gemini",
        "grok",
        "perplexity",
        "copilot",
        "custom"
      ],
      "description": "The assistant you are (recorded on the booking)"
    },
    "idempotency_key": {
      "type": "string",
      "minLength": 8,
      "maxLength": 200,
      "description": "Reuse to retry safely. Generated when omitted and returned in the result."
    }
  },
  "required": [
    "lot_id"
  ],
  "additionalProperties": false
}

Check a parking session: lot, status, start and end times, rate, amount so far and extensions, with a link to the driver's session page. No API key needed: ask the driver for the 6-character phone code on their receipt or pass and the last 3 characters of their plate (session_id with session_code also works). Any mismatch gets one answer, SESSION_NOT_FOUND: ask the driver to check both. With an API key (sessions:read), session_id alone reads a session on your account.

{
  "type": "object",
  "properties": {
    "phone_code": {
      "type": "string",
      "description": "The 6-character phone code printed on the driver's receipt or pass. Ask the driver for it."
    },
    "plate_last3": {
      "type": "string",
      "description": "The last 3 letters or numbers of the license plate parked on the session. Ask the driver for it."
    },
    "session_id": {
      "type": "string",
      "format": "uuid",
      "description": "Session id, from the driver's session page link. Without an API key, send it with session_code."
    },
    "session_code": {
      "type": "string",
      "description": "The session's code (sess_…), sent with session_id when there's no API key"
    }
  },
  "additionalProperties": false
}

Add time to an active hourly parking session. No API key needed: ask the driver for the phone code on their receipt or pass, the last 3 characters of their plate, and how many hours to add (0.5 to 8, in half-hour steps). The answer is the price, the new end time and a pay_url to the driver's session page: send the driver there to pay. Nothing is charged and the end time doesn't move until they pay. Any mismatch gets one answer, SESSION_NOT_FOUND. With an API key (sessions:write), session_id and session_code extend the session through the API.

{
  "type": "object",
  "properties": {
    "phone_code": {
      "type": "string",
      "description": "The 6-character phone code printed on the driver's receipt or pass. Ask the driver for it."
    },
    "plate_last3": {
      "type": "string",
      "description": "The last 3 letters or numbers of the license plate parked on the session. Ask the driver for it."
    },
    "session_id": {
      "type": "string",
      "description": "Session id. Without an API key, send it with session_code instead of the phone code."
    },
    "session_code": {
      "type": "string",
      "description": "The session's code (sess_…), for verification"
    },
    "extend_hours": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 24,
      "default": 1,
      "description": "Hours to add. Ask the driver. Without an API key: 0.5 to 8, in half-hour steps."
    }
  },
  "additionalProperties": false
}