---
title: "Observed crowd index"
method: GET
path: "/v1/parks/{park}/crowds/actuals"
tags: ["Parks"]
---

# Observed crowd index

`GET /v1/parks/{park}/crowds/actuals`

## Request

- Base URL: `https://api.parkypass.com`
- URL: `https://api.parkypass.com/v1/parks/{park}/crowds/actuals`
- Auth: one of:
  - none
  - HTTP bearer
  - API key in header `X-Parky-Key`

The observed crowd index for the last 1 to 60 park-local days (1.0 = the park's typical day), from midday posted waits, plus the forecast model's measured accuracy.

## Path parameters

- `park` string, required

## Query parameters

- `days` integer

## Response `200`

Success.

- CrowdActualsResponse
  - `schema_version` 1, required: Response format version. Fields are only added within a version.
  - `park_id` string, required
  - `park_key` string
  - `park_name` string
  - `requested_from` string, date
  - `requested_to` string, date
  - `days` object[], required
    - `date` string, date
    - `crowd_index` number, nullable: 1.0 = the park's typical day.
    - `midday_mean_wait_minutes` number, nullable
    - `rides_used` integer, nullable
    - `computed_at` string, date-time, nullable
  - `accuracy` CrowdAccuracy: How Parky's crowd forecast has scored against observed crowds for this park.
    - `days_scored` integer, nullable
    - `within_one_level_share` number, nullable: Share of days forecast within one level.
    - `mean_miss_levels` number, nullable
    - `baseline_mean_miss_levels` number, nullable: Mean miss of a naive day-of-week baseline.
    - `correlation` number, nullable
    - `reliable` boolean, nullable
    - `model_version` string, nullable
    - `updated_at` string, date-time, nullable
  - `note` string
  - `docs_url` string, uri, required: Developer documentation.
  - `attribution` Attribution, required: Required credit. Wherever Parky data is shown, display `text` with a visible link to `url`; the link must stay visible.
    - `text` 'Live data from parkypass.com', required: Text to display.
    - `url` string, uri, required: The matching parkypass.com page to link.
    - `required` true, required: Always true: attribution is a condition of use.
  - `generated_at` string, date-time, required: When Parky built this response.

## Other responses

- `400`: Invalid input, such as a malformed date or out-of-range days. The message says the accepted range.
- `401`: Malformed, unknown or revoked key. Drop the key to use anonymous limits.
- `404`: Unknown park or ride. The message lists valid park keys or how to find ride IDs.
- `429`: Rate limit or stream limit reached.
- `503`: Parky's upstream data is unavailable or its read budget is spent. Retry after Retry-After.

---

[API](https://skmtc.dev/parkypass/apis/parky-api.md) · [All operations](https://skmtc.dev/parkypass/apis/parky-api/llms.txt) · [OpenAPI document](https://skmtc.dev/parkypass/apis/parky-api/revisions/c3abcb8be74f?raw)