---
title: "Get Demand Surges"
method: GET
path: "/v1/demand-surge/"
tags: ["Demand Surge API"]
---

# Get Demand Surges

`GET /v1/demand-surge/`

## Query parameters

- `min_surge_intensity` 's' | 'm' | 'l' | 'xl', required
- `date_from` string, date, required
- `location.place_id` string[]
- `location.origin` string[]
- `location.radius` string

## Response `200`

Successful Response

- DemandSurgeResponse
  - `count` integer, required — The number of identified demand surges given the search criteria.
  - `surge_dates` SurgeDate[] — An array of identified demand surges.
    - `date` string, date, required — The date of the identified demand surge.
    - `phq_attendance_sum` integer, required — The sum of all attendance based features in the identified demand surge.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/predicthq/apis/predicthq-events-api.md) · [All operations](https://skmtc.net/predicthq/apis/predicthq-events-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/predicthq/predicthq-events-api/revisions/66cd8ff349dd/schema)