---
title: "Search Events"
method: GET
path: "/v1/events/"
tags: ["Events API"]
---

# Search Events

`GET /v1/events/`

Search for events happening in a location and date range. Use our extensive filters to narrow down your results.

## Query parameters

- `active.gte` string, date-time
- `active.gt` string, date-time
- `active.lte` string, date-time
- `active.lt` string, date-time
- `active.tz` string
- `beam.analysis_id` string
- `beam.group_id` string
- `brand_unsafe.exclude` 'true' | 'false'
- `cancelled.gte` string, date-time
- `cancelled.gt` string, date-time
- `cancelled.lte` string, date-time
- `cancelled.lt` string, date-time
- `cancelled.tz` string
- `category` string[]
- `country` string[]
- `deleted_reason` string[]
- `end.gte` string, date-time
- `end.gt` string, date-time
- `end.lte` string, date-time
- `end.lt` string, date-time
- `end.tz` string
- `entity.id` string[]
- `first_seen.gte` string, date-time
- `first_seen.gt` string, date-time
- `first_seen.lte` string, date-time
- `first_seen.lt` string, date-time
- `first_seen.tz` string
- `id` string[]
- `impact.gte` string, date-time
- `impact.gt` string, date-time
- `impact.lte` string, date-time
- `impact.lt` string, date-time
- `impact.tz` string
- `impact.industry` 'accommodation' | 'cpg' | 'tourism' | 'marketing' | 'parking' | 'restaurants' | 'retail' | 'transportation'
- `label` string[] — Legacy labels to further categorise the event.
- `local_rank.gte` integer
- `local_rank.gt` integer
- `local_rank.lte` integer
- `local_rank.lt` integer
- `local_rank_level` integer[]
- `location_confidence_score.gte` integer
- `location_confidence_score.gt` integer
- `location_confidence_score.lte` integer
- `location_confidence_score.lt` integer
- `parent.include` 'true' | 'false' | 'only'
- `phq_attendance.gte` integer
- `phq_attendance.gt` integer
- `phq_attendance.lte` integer
- `phq_attendance.lt` integer
- `phq_label` string[]
- `phq_label.op` 'all' | 'any'
- `phq_label.exclude` string[]
- `phq_label.exclude.op` 'all' | 'any'
- `place.scope` string[]
- `place.exact` string[]
- `placekey` string[]
- `postponed.gte` string, date-time
- `postponed.gt` string, date-time
- `postponed.lte` string, date-time
- `postponed.lt` string, date-time
- `postponed.tz` string
- `predicted_end.gte` string, date-time
- `predicted_end.gt` string, date-time
- `predicted_end.lte` string, date-time
- `predicted_end.lt` string, date-time
- `predicted_end.tz` string
- `predicted_event_spend.gte` integer
- `predicted_event_spend.gt` integer
- `predicted_event_spend.lte` integer
- `predicted_event_spend.lt` integer
- `predicted_event_spend_industry.<industry>.<suffix>` integer
- `private.include` 'true' | 'false' | 'only'
- `private.user_id` string[]
- `private.org_review` string[]
- `q` string
- `rank.gte` integer
- `rank.gt` integer
- `rank.lte` integer
- `rank.lt` integer
- `rank_level` integer[]
- `saved_location.location_id` string[]
- `sort` string[]
- `start.gte` string, date-time
- `start.gt` string, date-time
- `start.lte` string, date-time
- `start.lt` string, date-time
- `start.tz` string
- `start_date_confidence_score.gte` integer
- `start_date_confidence_score.gt` integer
- `start_date_confidence_score.lte` integer
- `start_date_confidence_score.lt` integer
- `state` string[]
- `updated.gte` string, date-time
- `updated.gt` string, date-time
- `updated.lte` string, date-time
- `updated.lt` string, date-time
- `updated.tz` string
- `within` string
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- EventsResponse — Paginated response containing events.
  - `count` integer, required — The total number of results.
  - `overflow` boolean, required — Indicates if there are more results than the subscription allows.
  - `previous` string, required — URL to the previous page of results, or null if on the first page.
  - `next` string, required — URL to the next page of results, or null if on the last page.
  - `results` Event[], required — List of event records.
    - `id` string, required — Unique identifier of the event.
    - `category` string, required — Category classification of the event (e.g. `conferences`, `sports`, `concerts`).
    - `title` string, required — Display name of the event as it appears in the PredictHQ event catalog.
    - `start_local` string, date-time, required — Start date and time of the event in local time.
    - `end_local` string, date-time, required — End date and time of the event in local time.
    - `phq_rank` integer — PHQ Rank score from 0–100 indicating the predicted attendance impact of the event.
    - `local_rank` integer, nullable — Local Rank score from 0–100 indicating relative local significance. Null for non-attended events.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `403` — Forbidden

---

[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)