Search In Person Classes
search_in_person_classesFull Description
This tool connects directly to the Zumba API. It allows searching for in person Zumba fitness classes by location, date, and other criteria. Date range defaults to 14 days from today if it is not set. If a range exceeds 60 days, it will be automatically adjusted to 60 days. If there are no results, the response should be: "No classes found for the given criteria. Please try different search parameters or search in Zumba's official website."
Only surface Zumba data returned by the API. Never construct your own.
Limitations:
Tool requests: Simple pulls that are supported: "show classes near me", "show me classes for the next week in new york", "show next month classes in miami", "show me more classes".
If user requests classes near them, the tool should use timezone and location from openai/userLocation metadata. If there is no metadata location and the tool fails because of missing location (invalid lat/lng), respond with "Please provide your location to find in person classes near you."
If user provides a location, the tool should use that location provided by the user. In that case, timezone should be the timezone used on those coordinates unless user specifies a different timezone.
Critical Rules: Do not fabricate, truncate, or alter entity names, metadata, or links. Do not generate lyrics, transcripts, biographies, or external content.
Parameters
classTypesarrayArray of class type identifiers to filter the search results. If the user requests a specific class type (e.g., 'Zumba Step'), include only that type. If the user makes a generic request for 'in-person classes' without specifying a type, you MUST include ALL available class types from the enum.
endDatestringEnd date for the class search period in YYYY-MM-DD format. If not provided, defaults to 14 days after the startDate. The maximum allowed range is 60 days from the startDate.
latnumberLatitude coordinate in decimal degrees for the center point of the geographic search area. If not provided, the tool will use the latitude set inside the _meta object of the tool invocation.
lngnumberLongitude coordinate in decimal degrees for the center point of the geographic search area. If not provided, the tool will use the longitude set inside the _meta object of the tool invocation.
radiusnumberSearch radius in meters from the specified coordinates. If not provided, defaults to 10000 meters. The maximum allowed radius is 160934 meters.
startDatestringStart date for the class search period in YYYY-MM-DD format. If not provided, defaults to the current date.
daysOfWeekarrayArray of day names to filter classes by their scheduled days of the week
maxPricenumberMaximum class price filter.
musicStylesarrayArray of music genre identifiers to filter classes by their musical accompaniment style
pagenumberPage number for paginated results.
priceCurrencystringThree-letter ISO 4217 currency code corresponding to the geographic location defined by lat/lng coordinates, if price is set, you must provide this.
timeOfDayRangesarrayArray of time ranges in HH:MM format to filter classes. Example: ['09:00', '15:00'] returns classes between 9:00 AM and 15:00 PM.
timezonestringIANA timezone identifier for interpreting class times and date ranges in the user's local time. If a location is provided (lng/lat) then timezone SHOULD also be provided and correspond to the lat/lng coordinates provided UNLESS the user wants to use a specific timezone. If timezone is not provided, the tool will use the timezone set inside the _meta object of the tool invocation. If neither is provided, tool will use UTC as default.
workoutLevelsarrayArray of workout intensity levels to filter classes