---
title: "Event Search"
method: GET
path: "/discovery/v2/events"
---

# Event Search

`GET /discovery/v2/events`

Find events and filter your search by location, date, availability, and much more.

## Query parameters

- `sort` string
- `startDateTime` string
- `endDateTime` string
- `onsaleStartDateTime` string
- `onsaleOnStartDate` string
- `onsaleOnAfterStartDate` string
- `onsaleEndDateTime` string
- `city` string
- `countryCode` string
- `stateCode` string
- `postalCode` string
- `venueId` string
- `attractionId` string
- `segmentId` string
- `segmentName` string
- `classificationName` unknown[]
  - unknown
- `classificationId` unknown[]
  - unknown
- `marketId` string
- `promoterId` string
- `dmaId` string
- `includeTBA` 'yes' | ' no' | ' only'
- `includeTBD` 'yes' | ' no' | ' only'
- `clientVisibility` string
- `latlong` string
- `radius` string
- `unit` 'miles' | 'km'
- `geoPoint` string
- `keyword` string
- `id` string
- `source` 'ticketmaster' | ' universe' | ' frontgate' | ' tmr'
- `includeTest` 'yes' | ' no' | ' only'
- `page` string
- `size` string
- `locale` string
- `includeLicensedContent` 'yes' | ' no'
- `includeSpellcheck` 'yes' | ' no'

## Response `200`

successful operation

## Changes

- **2017-08-08** (v2) `403113c95e88` — 1 warning
  - deleted the `query` request parameter `autocorrect`
- **2017-06-16** (v2) `d546ab8df76f` — 1 warning
  - deleted the `query` request parameter `nlp`
- **2017-06-07** (v2) `84dc5b83c046` — 2 info
  - added the new optional `query` request parameter `autocorrect`
  - added the new optional `query` request parameter `includeSpellcheck`
- **2017-06-06** (v2) `2261f5df7bb0` — 1 info
  - added the new optional `query` request parameter `geoPoint`
- **2017-04-12** (v2) `cafed74c985d` — 6 info
  - added the new optional `query` request parameter `city`
  - added the new optional `query` request parameter `includeLicensedContent`
  - added the new optional `query` request parameter `nlp`
  - added the new optional `query` request parameter `onsaleOnAfterStartDate`
  - …2 more

[Full history](https://skmtc.dev/ticketmaster-api/apis/discovery-api/changes/discovery/v2/events/get.md)

---

[API](https://skmtc.dev/ticketmaster-api/apis/discovery-api.md) · [All operations](https://skmtc.dev/ticketmaster-api/apis/discovery-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ticketmaster-api/discovery-api/revisions/d5a426e40d9e/schema)