---
title: "Featured Event"
method: GET
path: "/v3/events/featured"
tags: ["Events"]
---

# Featured Event

`GET /v3/events/featured`

This endpoint returns the featured event for a given location. Featured events are chosen by Yelp's community managers.

## Parameters

- `#/paths/~1v3~1events/get/parameters/10` — unresolved $ref
- `#/paths/~1v3~1events/get/parameters/11` — unresolved $ref
- `#/paths/~1v3~1events/get/parameters/12` — unresolved $ref
- `#/paths/~1v3~1events/get/parameters/0` — unresolved $ref

## Response `200`

A featured event was returned.

- object
  - `id` string, required — Unique ID of the event.
  - `name` string, nullable — Name of the event.
  - `description` string, nullable — Description excerpt of this event.
  - `business_id` string, nullable — Yelp Business ID of this event. No ID is returned if a business is not associated with an event.
  - `category` string, nullable — The category of the event.
  - `cost` number, nullable — Cost of attending the event.
  - `cost_max` number, nullable — Maximum cost of attending the event.
  - `event_site_url` string, nullable — Yelp page of the event.
  - `image_url` string, nullable — Yelp image URL of the event.
  - `tickets_url` string, nullable — URL to buy tickets for the event.
  - `attending_count` integer — Number of Yelp users attending the event.
  - `interested_count` integer — Number of Yelp users interested in attending the event.
  - `is_canceled` boolean — Whether the event is canceled.
  - `is_free` boolean — Whether the event is free.
  - `is_official` boolean — Whether the event is created by a Yelp community manager.
  - `location` object, nullable — Location object of the event. Includes address, city, state, zip code and country.
    - `address1` string, nullable — Street address of the event.
    - `address2` string, nullable — Street address of the event, continued.
    - `address3` string, nullable — Street address of the event, continued.
    - `city` string, nullable — City of the event.
    - `state` string, nullable — State of the event.
    - `zip_code` string, nullable — Zip code of the event.
    - `country` string, nullable — The [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of the location of the event. Country the event is taking place in.
    - `display_address` string[], nullable — Array of strings that if organized vertically give an address that is in the standard address format for the event's country.
    - `cross_streets` string, nullable — Cross streets of this address
  - `latitude` number, float, nullable — Latitude of the event location.
  - `longitude` number, float, nullable — Longitude of the event location.
  - `time_start` string, required — Time the event starts. Returns date and time in ISO 8601 format.
  - `time_end` string, nullable — Time the event ends. Returns date and time in ISO 8601 format.

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `404` — unresolved $ref
- `413` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref
- `503` — unresolved $ref

---

[API](https://skmtc.net/yelp/apis/businesses.md) · [All operations](https://skmtc.net/yelp/apis/businesses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yelp/businesses/revisions/d3f744f55ed7/schema)