Quickstart

Four short steps, about two minutes. No sign-up until the last one, and it is optional. Pick a park; every snippet on this page follows it.

1. Call one URL

   Live waits for every ride at the park, as JSON. Run it in a terminal, or press Try it.

   curl

   Copy

   1curl https://api.parkypass.com/v1/parks/magic-kingdom/waits

   GEThttps://api.parkypass.com/v1/parks/magic-kingdom/waits

   TRY IT

   You get rides, each with name, status and wait_minutes, and an attribution object. Every response has one.

2. Put waits on a page

   Save this as waits.html and open it in a browser. It works as it is.

   waits.html

   Copy

   1<!doctype html>2<html lang="en">3<head>4  <meta charset="utf-8">5  <meta name="viewport" content="width=device-width, initial-scale=1">6  <title>Magic Kingdom waits</title>7  <style>8    body { font: 16px/1.5 system-ui, sans-serif; max-width: 32rem; margin: 2rem auto; padding: 0 1rem; }9    li { display: flex; justify-content: space-between; padding: 0.4rem 0; border-bottom: 1px solid #ddd; }10  </style>11</head>12<body>13  <h1>Magic Kingdom waits</h1>14  <ul id="waits"></ul>15  <!-- Required: keep the "Live data from parkypass.com" link visible on every page that shows this data. -->16  <p><a id="credit" href="https://parkypass.com/">Live data from parkypass.com</a></p>1718  <script type="module">19    const res = await fetch("https://api.parkypass.com/v1/parks/magic-kingdom/waits");20    const data = await res.json();2122    const credit = document.getElementById("credit");23    credit.href = data.attribution.url;24    credit.textContent = data.attribution.text;2526    document.getElementById("waits").replaceChildren(...data.rides.map((ride) => {27      const item = document.createElement("li");28      const wait = ride.wait_minutes !== null ? ride.wait_minutes + " min" : ride.status;29      item.append(ride.name, Object.assign(document.createElement("b"), { textContent: wait }));30      return item;31    }));32  </script>33</body>34</html>

   You see every ride with its wait, and a “Live data from parkypass.com” link under the list. That link is the one condition of using the API: keep it on any page that shows the data.

3. Make it live

   Swap the script for a WebSocket and the page updates itself. Parky sends the whole board once, then only the rides that change.

   waits.html

   Copy

   1<!doctype html>2<html lang="en">3<head>4  <meta charset="utf-8">5  <meta name="viewport" content="width=device-width, initial-scale=1">6  <title>Magic Kingdom waits</title>7  <style>8    body { font: 16px/1.5 system-ui, sans-serif; max-width: 32rem; margin: 2rem auto; padding: 0 1rem; }9    li { display: flex; justify-content: space-between; padding: 0.4rem 0; border-bottom: 1px solid #ddd; }10  </style>11</head>12<body>13  <h1>Magic Kingdom waits</h1>14  <ul id="waits"></ul>15  <!-- Required: keep the "Live data from parkypass.com" link visible on every page that shows this data. -->16  <p><a id="credit" href="https://parkypass.com/">Live data from parkypass.com</a></p>1718  <script type="module">19    const rides = new Map();20    const socket = new WebSocket("wss://api.parkypass.com/v1/stream");2122    socket.onmessage = (event) => {23      const message = JSON.parse(event.data);24      // Subscribe only once the server says it is ready.25      if (message.type === "ready") socket.send(JSON.stringify({ type: "subscribe", parks: ["magic-kingdom"] }));26      if (message.type !== "snapshot" && message.type !== "changes") return;2728      const credit = document.getElementById("credit");29      credit.href = message.attribution.url;30      credit.textContent = message.attribution.text;3132      if (message.type === "snapshot") rides.clear();33      for (const ride of message.rides) rides.set(ride.ride_id, ride);34      document.getElementById("waits").replaceChildren(...[...rides.values()].map((ride) => {35        const item = document.createElement("li");36        const wait = ride.wait_minutes !== null ? ride.wait_minutes + " min" : ride.status;37        item.append(ride.name, Object.assign(document.createElement("b"), { textContent: wait }));38        return item;39      }));40    };41  </script>42</body>43</html>

   The list fills in a second, then changes on its own. Posted waits usually move every few minutes, so quiet minutes are normal. Live updates has every message.

4. Get a key

   Optional. Without a key you get 30 requests a minute; a free key gives 120 and 20,000 a day. Create one, then send it with each request:

   curl

   Copy

   1curl -H "Authorization: Bearer pk_live_…" https://api.parkypass.com/v1/parks/magic-kingdom/waits