List place classes

Response

A 200 returns application/json with these fields.

• dataarray of Classalways present

  • idstring (uuid)always present
  • typestringalways present
  • slugstring · nullable
  • namestringalways present
  • descriptionstring · nullable
  • programobjectalways present

    • enrollment_typestring · nullable
      enrollmentunknownnull
    • skill_level_notesstring · nullable
    • adult_participationstring · nullable

      Whether a parent or caregiver takes part or has to stay. One of required, optional, drop_off, not_allowed or varies. Which of these appear depends on what each provider states, so treat the set as open and handle an unrecognised value as "not stated". null means the source does not state it for this class. It never means "no adult needed", and it is not inferred from the ages. Providers often put this rule on a separate FAQ or policy page rather than on the class itself.

    • what_youll_learnstring · nullable
    • prerequisitesstring · nullable
  • termobjectalways present

    The dated block the tuition buys.

    • namestring · nullable

      e.g. "Fall 2026".

    • starts_onstring (date) · nullable
    • ends_onstring (date) · nullable
    • total_classesinteger · nullable

      Number of class meetings in the series, only when the class's own text states it (for example "8 classes" or an "8-week session" that meets once a week). null means the source does not state it, including for rolling, drop-in, open and year-round classes, which have no total. It is not worked out from the term dates, and a stated total can differ from the meetings actually held if the provider skips a week.

  • scheduleobjectalways present

    • typestring · nullable

      One of session, ongoing, ...

    • daysarray of string

      Lower-case weekday names.

    • start_timestring · nullable

      HH:MM:SS local.

    • end_timestring · nullable
    • duration_minutesinteger · nullable
    • is_recurringboolean · nullable
    • rrulestring · nullable

      RFC 5545 RRULE, e.g. FREQ=WEEKLY;BYDAY=SA.

    • notesstring · nullable

      Verbatim schedule wording.

    • timezonestring

      Metro timezone (class times have no zone column).

  • tuitionobjectalways present

    • amountnumber · nullable
    • fromnumber · nullable

      The lowest tuition among the program's sections; the program's own amount when no section states one. Use it for "from $X" displays.

    • textstring · nullable

      Verbatim, e.g. "$460 / 16-week session".

    • drop_in_pricenumber · nullable

      Price to attend a single class without enrolling in the term, when the provider states one for everyone. null means the source does not state it; it does not mean drop-ins are unavailable. A price that applies only to some people (members, residents, an age group) is not filled.

    • trial_pricenumber · nullable

      Price of a trial class; 0 is a free trial. null means the source does not state a trial price; it does not mean no trial is offered. A trial offered only under conditions is not filled.

    • trial_notesstring · nullable

      The provider's own wording about the trial, when trial_price is set.

    • currencystring
  • pricePricealways present

    • typestring · nullable

      An explicit amount beats the word "free" when they disagree. Some older rows carry variable where newer rows use range for a non-fixed amount.

      freefixedrangevariablenull
    • minnumber · nullable

      Minimum price.

    • maxnumber · nullable

      Maximum price.

    • scopestring · nullable

      What the amounts refer to. May be null on older rows.

      admissionfree_admission_paid_extrasmembers_freeage_freeper_itemnull
    • notestring · nullable

      Verbatim price wording.

    • unitstring · nullable

      One of per_child, per_session when stated.

    • is_freeboolean

      True when the stated price type is free, or — absent a stated price — when the source itself marked the listing free.

    • currencystring

      All listing prices are decimal dollars, never cents.

  • agesAgesalways present

    • mininteger · nullable

      Minimum age, in years. null means the source does not state one; 0 is only reported when the listing states it (with a maximum or age wording, e.g. 0–5), never as a stand-in for "not stated".

    • maxinteger · nullable

      Maximum age, in years.

    • textstring · nullable

      Verbatim age wording. Populated for classes; null for events and camps today.

    • audiencestring · nullable

      Audience the source page states. A listing flagged as adult-only content reads adults here whatever the page says, matching the top-level audience. Adult/senior/private rows are normally not published; the value is exposed so consumers can double-check.

      kidsfamilyteensadultsseniorsprivatenull
    • bandsarray of string · nullable

      Derived age bands.

  • audiencestring

    Who the listing is for, derived from a suitability check we run on the listing (not the source page's own wording) and refined by ages: adult_only reads adults; mixed reads all_ages; kid_friendly/young_kids/bigger_kids become teens when ages.audience says teens or ages.max is 13 or older, families when ages.audience says family, else kids. Always present. A listing flagged as adult-only content always reads adults, whatever audience wording its source page uses. Filter with audience=; the default excludes adults.

    kidsfamiliesteensadultsall_ages
  • traitsTraits

    Events, classes and camps only.

    • seasonsarray of string

      Every season the listing's own date range touches — a multi-day event or a term can carry more than one. Events: starts_local/ ends_local. Classes: the term's starts_on/ends_on; an ongoing or dateless term is []. Camps: the camp's own season column when stated, else its span dates. Filter with season=.

      springsummerfallwinter
  • is_indoorboolean · nullable

    Whether the linked place is indoors, as the place states it. Inherited through place.id, never inferred from this listing's title or text. null means unknown: no linked place, or the place does not say.

  • is_outdoorboolean · nullable

    Whether the linked place is outdoors, as the place states it; null when unknown. A place can be both.

  • good_for_rainyboolean · nullable

    Whether the linked place states it suits a rainy day; null when unknown.

  • is_sensory_friendlyboolean · nullable

    Whether the linked place advertises sensory-friendly accommodation (quiet spaces, low stimulation); null when unknown.

  • placePlaceRefalways present

    The place a listing is held at — the linked place listing when one exists. The row's own address is location.

    • idstring (uuid) · nullablealways present

      The linked place's id (a published place) or null.

    • slugstring · nullablealways present

      The linked place's slug; /v1/places/slug/{slug} resolves it.

    • namestring · nullablealways present

      Linked place's name. Null when unlinked — the address line often still names the place.

  • locationLocationalways present

    Where the row itself is — its own geocoded address, coordinates and neighborhood — whether or not it is linked to a place.

    • addressstring · nullable
    • street_addressstring · nullable
    • citystring · nullable
    • statestring · nullable
    • zipstring · nullable
    • latnumber · nullable

      The listing's own geocoded latitude, or — when beta geo filters are enabled and the listing has none of its own — an approximate point instead. Whichever it is, geo_precision on this same object says how much to trust it.

    • lngnumber · nullable

      See lat.

    • neighborhoodstring · nullable
    • neighborhood_slugstring · nullable

      What neighborhood= takes.

    • geo_precisionstring · nullable

      Present only when beta geo filters are enabled; otherwise the key is absent, not null. rooftop | interpolated | street | place | zip_centroid | unknown | null (never geocoded). Null when the flag is off or the row carries none.

    • geo_sourcestring · nullable

      Present only when beta geo filters are enabled. The source category for the resolved coordinates, or null.

    • zip_sourcestring · nullable

      Present only when zip= was given and beta geo filters are enabled. Which postal-code representation matched this row.

  • occasionsarray of stringalways present

    Seasonal occasions this listing is tagged for, around each occasion's season. Empty when none.

    halloweenthanksgivingwinter_holidaysnew_yearlunar_new_yearvalentinesst_patrickseasterjuneteenthjuly_4thback_to_schoolsummer_break
  • categoriesarray of stringalways present

    All categories for the listing. The first is usually the primary one, but not always; a dedicated primary field is coming.

    arts_creativemusic_movementsports_active_playnature_outdoorsstorytime_booksstem_learningcooking_foodsocial_play_spaces
  • registrationobjectalways present

    • urlstring (uri) · nullable

      The registration link, when one is stated separately from the source page.

    • statusstring
      openclosedwaitlistcoming_soon
    • opens_atstring (date-time) · nullable
    • spots_remaininginteger · nullable

      Seats left, when the provider publishes a count. Most do not, so this is usually null (not stated by the source). Use status for the registration state.

    • has_spots_availableboolean

      true is the default and is not a confirmation that seats are open: it means we have not seen the provider say the class is full. false is reported only where we have read such a statement, so do not rely on it to find every full class.

    • waitlist_availableboolean
    • sections_with_spotsinteger

      How many of the program's sections are known to have room (seats left, or marked available, and not closed). Sections with unknown availability are not counted.

  • sections_totalintegeralways present

    How many sections the program has. 0 when it has none.

  • sectionsarray of ClassSectionalways present

    The program's sections (its variants: a day and time, an age group, a term), always present and empty when the program has none. registration.has_spots_available is true when the program or any section has seats. Filters never trim this list; see schedule_day, age, openings and the other filters on the list operation for how a program is matched.

    • idstringalways present

      Stable identifier of the section within its program.

    • namestring · nullablealways present
    • scheduleobjectalways present

      • daysarray of string

        Lower-case weekday names.

      • start_timestring · nullable

        HH:MM:SS local.

      • end_timestring · nullable
      • duration_minutesinteger · nullable
      • rrulestring · nullable
      • notesstring · nullable
      • timezonestring

        Metro timezone.

    • termobjectalways present

      • namestring · nullable
      • starts_onstring (date) · nullable
      • ends_onstring (date) · nullable
      • total_classesinteger · nullable
    • agesobjectalways present

      • mininteger · nullable
      • maxinteger · nullable
      • textstring · nullable
    • tuitionobjectalways present

      • amountnumber · nullable
      • textstring · nullable
      • drop_in_pricenumber · nullable
      • currencystring
    • registrationobjectalways present

      • urlstring (uri) · nullable
      • statusstring
        openclosedwaitlistcoming_soon
      • spots_remaininginteger · nullable

        Seats left, only when the provider publishes a count.

      • has_spots_availableboolean · nullable

        null when the provider does not say.

      • waitlist_availableboolean · nullable
    • updated_atstring (date-time) · nullablealways present
  • sessionsarray of objectalways present

    On a list, other classes the program card stands for when a provider's pages publish the same program as separate listings. Each is a complete class (the same object, without sessions) that can also be fetched on its own. Always present; empty on a detail read, on an ungrouped card, and when the request asks for every class on its own with expand=sessions.

  • image_urlstring (uri) · nullable
  • organizationOrganizationRef

    • idstring (uuid) · nullable

      The linked organization's id, or null.

    • namestring · nullable
    • slugstring · nullable
  • confidencenumberalways present

    Trust score. The same number min_confidence filters on — the score once the listing has been verified, else the documented baseline. A flat field, not a nested object, to keep the default payload small; detail is behind include=source.

  • verified_atstring (date-time) · nullablealways present

    When we last confirmed the source page still states this listing. Null for a listing not yet verified, or one that has never been verified.

  • metrostringalways present
  • statusstringalways present

    Lists and the default detail read return published only; archived appears only under include_archived=true, and is what a consumer renders a "this has passed" banner from. draft is never served.

    publishedarchived
  • created_atstring (date-time)
  • updated_atstring (date-time)always present

    The latest of the listing's own update and its class details.

  • linksListingLinksalways present

    Relative paths for this item and, when linked, its place and organization.

    • selfstringalways present

      This item.

    • placestring

      Present when the item has a linked place.

    • organizationstring

      Present when the item has a linked organization.

  • expandedExpanded

    Present only when expand= was given; each key present only when asked for.

    • placePlace · nullable

      A place, classified by type_hint. A more granular classification field is planned for a future version.

      • idstring (uuid)always present
      • typestringalways present
      • slugstring · nullable
      • namestringalways present
      • descriptionstring · nullable
      • type_hintstringalways present

        Served as type_hint.

        play_spacemuseumparklibrarytheatersports_facilityfarmrestaurantother
      • type_hint_notesstring · nullable
      • locationLocationalways present

        Where the row itself is — its own geocoded address, coordinates and neighborhood — whether or not it is linked to a place.

        • addressstring · nullable
        • street_addressstring · nullable
        • citystring · nullable
        • statestring · nullable
        • zipstring · nullable
        • latnumber · nullable

          The listing's own geocoded latitude, or — when beta geo filters are enabled and the listing has none of its own — an approximate point instead. Whichever it is, geo_precision on this same object says how much to trust it.

        • lngnumber · nullable

          See lat.

        • neighborhoodstring · nullable
        • neighborhood_slugstring · nullable

          What neighborhood= takes.

        • geo_precisionstring · nullable

          Present only when beta geo filters are enabled; otherwise the key is absent, not null. rooftop | interpolated | street | place | zip_centroid | unknown | null (never geocoded). Null when the flag is off or the row carries none.

        • geo_sourcestring · nullable

          Present only when beta geo filters are enabled. The source category for the resolved coordinates, or null.

        • zip_sourcestring · nullable

          Present only when zip= was given and beta geo filters are enabled. Which postal-code representation matched this row.

      • hoursobject

        Verbatim per-day hours; null when unknown.

        • mondaystring · nullable
        • tuesdaystring · nullable
        • wednesdaystring · nullable
        • thursdaystring · nullable
        • fridaystring · nullable
        • saturdaystring · nullable
        • sundaystring · nullable
        • notesstring · nullable
        • exceptionsstring · nullable
      • admissionobject

        • typestring · nullable
        • child_pricenumber · nullable
        • adult_pricenumber · nullable
        • infant_age_cutoffinteger · nullable
        • notesstring · nullable
        • currencystring
      • membershipobject

        • availableboolean
        • price_monthlynumber · nullable
        • price_annualnumber · nullable
        • notesstring · nullable
        • currencystring
      • birthday_partiesobject

        • availableboolean
        • min_guestsinteger · nullable
        • max_guestsinteger · nullable
        • age_rangestring · nullable
        • booking_urlstring (uri) · nullable
        • notesstring · nullable
      • classesobject

        • availableboolean
        • typesarray of string · nullable
        • age_rangestring · nullable
        • schedule_notesstring · nullable
        • registration_urlstring (uri) · nullable
      • amenitiesobject

        • has_outdoor_spaceboolean · nullable
        • has_parkingboolean · nullable
        • parking_notesstring · nullable
        • has_wifiboolean · nullable
        • socks_requiredboolean · nullable
        • outside_food_allowedboolean · nullable
        • stroller_policystring · nullable
      • is_sensory_friendlyboolean · nullable

        Whether the place advertises sensory-friendly accommodation (quiet spaces, low stimulation). null when the place does not say; places usually state it only when true. Events and classes at this place inherit it.

      • agesAgesalways present

        • mininteger · nullable

          Minimum age, in years. null means the source does not state one; 0 is only reported when the listing states it (with a maximum or age wording, e.g. 0–5), never as a stand-in for "not stated".

        • maxinteger · nullable

          Maximum age, in years.

        • textstring · nullable

          Verbatim age wording. Populated for classes; null for events and camps today.

        • audiencestring · nullable

          Audience the source page states. A listing flagged as adult-only content reads adults here whatever the page says, matching the top-level audience. Adult/senior/private rows are normally not published; the value is exposed so consumers can double-check.

          kidsfamilyteensadultsseniorsprivatenull
        • bandsarray of string · nullable

          Derived age bands.

      • audiencestring

        Who the listing is for, derived from a suitability check we run on the listing (not the source page's own wording) and refined by ages: adult_only reads adults; mixed reads all_ages; kid_friendly/young_kids/bigger_kids become teens when ages.audience says teens or ages.max is 13 or older, families when ages.audience says family, else kids. Always present. A listing flagged as adult-only content always reads adults, whatever audience wording its source page uses. Filter with audience=; the default excludes adults.

        kidsfamiliesteensadultsall_ages
      • categoriesarray of stringalways present

        All categories for the listing. The first is usually the primary one, but not always; a dedicated primary field is coming.

        arts_creativemusic_movementsports_active_playnature_outdoorsstorytime_booksstem_learningcooking_foodsocial_play_spaces
      • image_urlstring (uri) · nullable
      • imagesarray of string (uri) · nullable

        More photos of the place, after image_url (the primary image), deduplicated. Hosted by the provider's own site; link or attribute to website_url when displaying. null on include_archived detail reads, where it is not available.

      • website_urlstring (uri) · nullable

        Same as source.url (include=source) for places parsed from their own site.

      • organizationOrganizationRef

        • idstring (uuid) · nullable

          The linked organization's id, or null.

        • namestring · nullable
        • slugstring · nullable
      • confidencenumberalways present

        Trust score. The same number min_confidence filters on — the score once the listing has been verified, else the documented baseline. A flat field, not a nested object, to keep the default payload small; detail is behind include=source.

      • verified_atstring (date-time) · nullablealways present

        When we last confirmed the source page still states this listing. Null for a listing not yet verified, or one that has never been verified.

      • metrostringalways present
      • statusstringalways present

        Lists and the default detail read return published only; archived appears only under include_archived=true, and is what a consumer renders a "this has passed" banner from. draft is never served.

        publishedarchived
      • created_atstring (date-time)
      • updated_atstring (date-time)always present

        The latest of the listing's own update and its place details.

      • linksPlaceLinksalways present

        Relative paths for this place, its organization when linked, and its child collections.

        • selfstringalways present

          This place.

        • organizationstring

          Present when the place has a linked organization.

        • eventsstringalways present

          Events at this place — same as ?place_id= on /v1/{metro}/events.

        • classesstringalways present

          Classes at this place.

        • campsstringalways present

          Camps at this place.

      • expandedExpanded

        Present only when expand= was given; each key present only when asked for.

      • sourceSource

        Where the listing's data came from, and how it was verified — everything the lean default response leaves out. Present only with include=source, a paid add-on: 403 with error.code: include_not_permitted when the key is not entitled, or (include_mode=lenient) a 200 without this block plus a notices[] entry. See Shaping responses.

        • urlstring (uri) · nullablealways present

          The page the listing was parsed from.

        • crawled_atstring (date-time) · nullablealways present

          When that page was last fetched.

        • verificationobjectalways present

          How this listing was verified.

    • organizationOrganizationCore · nullable

      An Organization without metros.

      • idstring (uuid)always present
      • namestringalways present
      • slugstring · nullable
      • organization_typestring · nullable
      • website_urlstring (uri) · nullable

        The organization's own website. On GET /v1/{metro}/organizations, when none is recorded, the address of the site the organization itself runs, if we have one.

      • citystring · nullable
      • statestring · nullable
      • is_verifiedboolean · nullable
      • linksOrganizationLinksalways present

        Relative paths for this organization's own resource and its child collections.

        • selfstringalways present

          This organization.

        • eventsstringalways present

          Events run by this organization.

        • classesstringalways present

          Classes run by this organization.

        • campsstringalways present

          Camps run by this organization.

        • placesstringalways present

          Places owned by this organization.

  • sourceSource

    Where the listing's data came from, and how it was verified — everything the lean default response leaves out. Present only with include=source, a paid add-on: 403 with error.code: include_not_permitted when the key is not entitled, or (include_mode=lenient) a 200 without this block plus a notices[] entry. See Shaping responses.

    • urlstring (uri) · nullablealways present

      The page the listing was parsed from.

    • crawled_atstring (date-time) · nullablealways present

      When that page was last fetched.

    • verificationobjectalways present

      How this listing was verified.

      • statusstring · nullablealways present

        The outcome of the last check against the source page, null before the listing has been checked. flagged means a specific audience or content problem was found, backed by evidence — a real, reachable outcome, just an uncommon one. unverifiable means the check could not confirm the listing either way. Treat any other string as unknown, not as one of these.

        clearchangedflaggedunverifiableunreachablegonenull
      • basisstringalways present

        Who produced confidence. verified once the listing has been verified, else the documented baseline. Part of source.verification (include=source).

        verifiedbaseline
      • date_basisstring · nullablealways present

        How the listing's date was established: stated (the source page gave it directly), inferred (derived, e.g. from a recurrence rule), unevidenced (present but not traceable to a source statement), or unknown (not yet classified). null on older rows scored before this field existed.

        statedinferredunevidencedunknownnull
  • relatedRelated

    Present with include=related on a single event, class or camp (see Include). Three lists of at most six cards each, from the same listings the list endpoints serve to the same key.

    • similararray of RelatedCardalways present

      Nearby listings of the same kind, in the same Monday-to-Sunday week as this listing's date (the next date, for a series), in a matching category, with overlapping ages (unstated ages overlap). Never this listing, its series, its organization or its place. Nearest first, then closest in date.

      • idstring (uuid)always present
      • slugstring · nullable
      • typestringalways present
        eventclasscamp
      • namestringalways present
      • starts_atstring (date-time) · nullable

        Events: the start (UTC) of the relevant occurrence, the next one for a series. Null for classes and camps.

      • ends_atstring (date-time) · nullable
      • starts_onstring (date) · nullable

        Events: the local date of the occurrence. Classes and camps: the term or span start.

      • ends_onstring (date) · nullable
      • placeobject · nullable

        • idstring (uuid) · nullable
        • namestring · nullable
      • image_urlstring (uri) · nullable
      • pricePrice · nullable

        The listing's price, as the list endpoints return it.

        • typestring · nullable

          An explicit amount beats the word "free" when they disagree. Some older rows carry variable where newer rows use range for a non-fixed amount.

          freefixedrangevariablenull
        • minnumber · nullable

          Minimum price.

        • maxnumber · nullable

          Maximum price.

        • scopestring · nullable

          What the amounts refer to. May be null on older rows.

          admissionfree_admission_paid_extrasmembers_freeage_freeper_itemnull
        • notestring · nullable

          Verbatim price wording.

        • unitstring · nullable

          One of per_child, per_session when stated.

        • is_freeboolean

          True when the stated price type is free, or — absent a stated price — when the source itself marked the listing free.

        • currencystring

          All listing prices are decimal dollars, never cents.

      • is_freebooleanalways present
    • from_organizationarray of RelatedCardalways present

      The organization's next upcoming listings of the same type, soonest first, one card per series, without this listing.

      • idstring (uuid)always present
      • slugstring · nullable
      • typestringalways present
        eventclasscamp
      • namestringalways present
      • starts_atstring (date-time) · nullable

        Events: the start (UTC) of the relevant occurrence, the next one for a series. Null for classes and camps.

      • ends_atstring (date-time) · nullable
      • starts_onstring (date) · nullable

        Events: the local date of the occurrence. Classes and camps: the term or span start.

      • ends_onstring (date) · nullable
      • placeobject · nullable

        • idstring (uuid) · nullable
        • namestring · nullable
      • image_urlstring (uri) · nullable
      • pricePrice · nullable

        The listing's price, as the list endpoints return it.

        • typestring · nullable

          An explicit amount beats the word "free" when they disagree. Some older rows carry variable where newer rows use range for a non-fixed amount.

          freefixedrangevariablenull
        • minnumber · nullable

          Minimum price.

        • maxnumber · nullable

          Maximum price.

        • scopestring · nullable

          What the amounts refer to. May be null on older rows.

          admissionfree_admission_paid_extrasmembers_freeage_freeper_itemnull
        • notestring · nullable

          Verbatim price wording.

        • unitstring · nullable

          One of per_child, per_session when stated.

        • is_freeboolean

          True when the stated price type is free, or — absent a stated price — when the source itself marked the listing free.

        • currencystring

          All listing prices are decimal dollars, never cents.

      • is_freebooleanalways present
    • at_placearray of RelatedCardalways present

      Other listings at the same place in the same week, soonest first, without this listing.

      • idstring (uuid)always present
      • slugstring · nullable
      • typestringalways present
        eventclasscamp
      • namestringalways present
      • starts_atstring (date-time) · nullable

        Events: the start (UTC) of the relevant occurrence, the next one for a series. Null for classes and camps.

      • ends_atstring (date-time) · nullable
      • starts_onstring (date) · nullable

        Events: the local date of the occurrence. Classes and camps: the term or span start.

      • ends_onstring (date) · nullable
      • placeobject · nullable

        • idstring (uuid) · nullable
        • namestring · nullable
      • image_urlstring (uri) · nullable
      • pricePrice · nullable

        The listing's price, as the list endpoints return it.

        • typestring · nullable

          An explicit amount beats the word "free" when they disagree. Some older rows carry variable where newer rows use range for a non-fixed amount.

          freefixedrangevariablenull
        • minnumber · nullable

          Minimum price.

        • maxnumber · nullable

          Maximum price.

        • scopestring · nullable

          What the amounts refer to. May be null on older rows.

          admissionfree_admission_paid_extrasmembers_freeage_freeper_itemnull
        • notestring · nullable

          Verbatim price wording.

        • unitstring · nullable

          One of per_child, per_session when stated.

        • is_freeboolean

          True when the stated price type is free, or — absent a stated price — when the source itself marked the listing free.

        • currencystring

          All listing prices are decimal dollars, never cents.

      • is_freebooleanalways present
• metaListMetaalways present

  • applied_filtersAppliedFiltersalways present

    The filters this response was actually computed with, as their request parameters: the value in effect for each filter the endpoint applies, whether you sent it or it came from a default. A filter that is unset (no category=, for instance) is absent, and a filter the endpoint does not apply (weekday on camps) is never listed. Always present: min_confidence and audience, plus from and to on events, classes and camps (to is null where the window is open-ended). The exception is a batch read by ids=: no window or filters apply, so only ids is listed. meta.defaults_applied names which of these came from a default.

    • fromstring (date)
    • tostring (date) · nullable
    • min_confidencenumber
    • audiencearray of string

      The audience filter in effect, in a form you can send back as audience= to get the same set. With no audience= given this is ["not_adults"]: every listing except adult-only ones. audience=all is echoed as ["all"]. A list you named is echoed as given.

      kidsfamiliesteensadultsall_agesallnot_adults
    • radius_minteger

      Present on a radius search.

    • idsarray of string (uuid)

      Present on a batch read by ids=, as the de-duplicated ids requested.

  • defaults_appliedarray of stringalways present

    The names in applied_filters whose value came from a default rather than your request, for example ["from", "to", "min_confidence", "audience"]. Empty when you named every filter that has a default. A default that narrows a result (the 30-day event window, the confidence floor, the adult-audience exclusion) is listed here so a smaller-than-expected set can be explained from the response alone.

  • metrostring · nullable
  • pageinteger · nullable

    Present in browse mode.

  • limitintegeralways present
  • countintegeralways present

    Items in this page.

  • has_morebooleanalways present
  • next_cursorstring · nullable

    Pass as cursor to fetch the next page (sync mode, or browse mode beyond page 1). Valid only for this exact request — same route, resource, metro, mode and filters. It does not expire on a clock, which is what lets a paged list keep a stable ETag.

  • missing_idsarray of string (uuid)

    Present only when the request used ids=: the requested ids that were not returned (unknown, another resource type or metro, or no longer active), in request order, without repeats.

  • min_confidencenumber

    The threshold applied.

  • occurrencesstring

    Present when the list is one item per occurrence (occurrences=expand).

    expand
  • windowobject · nullable

    The resolved date window, so a defaulted to is visible and a cursor can be re-issued for exactly this traversal. null on /places, which has no window; to is null on /classes and /camps when not given (their window is open-ended).

    • fromstring (date)always present
    • tostring (date) · nullablealways present
    • timezonestringalways present

      The metro's IANA zone the dates are read in.

  • searchobject

    Present when q= was given.

    • querystringalways present
    • cappedbooleanalways present

      Very broad queries may be capped; when they are, this is true — add filters or a more specific q to narrow results.

  • geoobject

    Present only when beta geo filters are enabled, and only when this request was spatial (lat/lng or near_zip, each with radius_m) or ZIP-filtered (zip=).

    • originobject

      Present when near_zip= resolved an origin.

      • latnumberalways present
      • lngnumberalways present
      • methodstringalways present
        zcta_internal_point
      • vintagestringalways present

        The current-vintage ZCTA5 boundary set the point was loaded from.

    • excluded_without_coordinatesinteger

      Present on any spatial query. Rows the radius walk scanned and dropped for having no usable point — no coordinates at all, or a geo_precision this query does not surface (unknown always, zip_centroid/place unless include_approximate=true). Not a count of rows merely outside the circle.

  • generated_atstring (date-time)
• facetsFacets

  Counts over the whole filtered set. Buckets: weekday is monday..sunday (an event's local day, or every day a class meets); time_block is morning (before 12:00), afternoon (12:00 to before 17:00) and evening (17:00 on), from the local start time; price_band is free (exactly the listings free=true returns), then under_20, 20_to_50, 50_to_100 and 100_plus from the lowest stated price in US dollars, with a listing that is not free and states no price above zero counted as unspecified; age_band is the same baby, toddler, young_kids, bigger_kids bands as ages.bands. Enumerated facets list every bucket, including zeros; category lists the buckets that occur, most first.

  • totalintegeralways present

    Listings the facets were counted over.

  • is_completebooleanalways present

    false when the set was too large to count in full, or counting ran out of time; the counts then cover part of it. Narrow the filters and ask again.

  • unavailablearray of string

    Requested facets this collection has no data for.

  • categoryarray of FacetCount

    • valuestringalways present

      The bucket. unspecified counts listings that state nothing for this facet.

    • countintegeralways present
  • weekdayarray of FacetCount

    • valuestringalways present

      The bucket. unspecified counts listings that state nothing for this facet.

    • countintegeralways present
  • time_blockarray of FacetCount

    • valuestringalways present

      The bucket. unspecified counts listings that state nothing for this facet.

    • countintegeralways present
  • price_bandarray of FacetCount

    • valuestringalways present

      The bucket. unspecified counts listings that state nothing for this facet.

    • countintegeralways present
  • age_bandarray of FacetCount

    • valuestringalways present

      The bucket. unspecified counts listings that state nothing for this facet.

    • countintegeralways present
  • organizationOrganizationFacet

    • distinctintegeralways present

      Organizations with at least one listing in the set.

    • toparray of objectalways present

      The organizations with the most listings, most first; capped at 20.

      • idstring (uuid)always present
      • namestring · nullablealways present
      • countintegeralways present
    • other_countintegeralways present

      Listings whose organization is not in top.

    • unspecified_countintegeralways present

      Listings with no organization.

• noticesarray of Notice

  Present only when there is at least one — see Notice.

  • codestringalways present

    The same vocabulary as Error.code, for the same reason — branch on this, not on message.

    include_not_permittedforecast_unavailablerelated_unavailable
  • includestring

    Which include= value this notice concerns.

  • messagestringalways present
  • upgrade_urlstring (uri)

    Where to compare plans when the omitted include is available by upgrade.

Status codes

• 200

  A page of classes. Each item carries confidence; source appears only when requested with include=source (a paid add-on).

• 400

  Malformed or contradictory parameters (lat without lng, to before from, unknown category), or a cursor this API did not issue for this exact request — replayed from another endpoint, resource, metro or filter set, hand-crafted, or altered.

• 401

  Missing, unknown or revoked X-API-Key. Also returned when the key record itself does not validate — the server fails closed and logs why rather than assuming anything about a row it cannot vouch for, and when the value is not shaped like a key (tl_ + 8 hex + _ + 48 hex). The message is invalid API key; the reason is not disclosed. The one exception is a credential shaped like a different kind of token, whose 401 explains it is the wrong credential for /v1 rather than repeating the generic message.

• 403

  Two different reasons share this status. Read error.code.

  Show more

  forbidden — the key is valid but its scopes exclude this metro or resource type, or the client is inactive. Returned when the caller named the metro or type it was refused — in the path, or in ?metro=. Where the caller supplied only an identifier, an out-of-scope resource is a 404 instead; see NotFound.

  include_not_permitted (endpoints that take include= only) — the key is valid and in scope, but is not entitled to a requested include= add-on (details.include names it). Add include_mode=lenient to get a 200 without the block instead of this. See Shaping responses.

• 404

  No published, active resource with that id (or unknown metro).

  Show more

  Also returned when the resource exists but sits in a metro outside the key's scopes.metros, on the routes that take an identifier rather than a metro: /v1/{type}/{id}, /v1/{type}/slug/{slug} and /v1/organizations/{id}. The metro there is discovered from the row, not named by the caller, so a 403 would confirm that a guessed id or slug is real and say which metro it is in. The two cases are deliberately indistinguishable — same code, same message, same absent details.

  Naming the metro is a different question and still gets the explicit 403 with the key's own scopes: /v1/boston/events, or ?metro=boston on a slug lookup.

• 405

  The path exists; the method does not. Every route on this API is a read, so Allow is always GET, HEAD, OPTIONS. A method on a path that does not exist is a 404 instead — 405 is only ever sent where there is a target resource to refuse.

• 429

  A limit was reached. Branch on error.code, not on the status — two different limits share this status:

  Show more

  • rate_limited — the per-minute rate. Retry-After is seconds, and retrying after it succeeds.
  • rate_limited can also mean address lookups are temporarily unavailable. The response explains the condition and provides Retry-After; callers that already have coordinates can send lat/lng instead.
  • quota_exceeded — the monthly allowance, or a client's hard cap. Retry-After points at the start of the next UTC month and can therefore be very large; details carries plan, monthly_limit, used and resets_at. Backing off will not help before the reset — the plan has to change. This is a 429; 402 is reserved.
• 500

  A bug on our side. The message is always the constant internal error; details are never included in the body. Retry once with backoff, then contact support with the request_id.

• 501

  This endpoint or feature is not available and will not become available without a configuration change — for ?address=, this means no geocoder is configured.

  Show more

  Nothing is failing, so do not retry and do not back off: there is no Retry-After, and the answer will not change inside any timeout you set. Treat the feature as switched off, disable it in your UI, and use the alternative the message names where there is one (lat/lng instead of address).

  The message is a constant per endpoint family and names no internal object. Include the request_id when contacting support.

• 503

  A transient outage: a dependency could not be reached or did not answer in time. This is the 5xx worth retrying — Retry-After says how long, and the same request is expected to succeed afterwards.

  Like every other error here, the message names no internal detail.

Every error uses the same envelope; branch on error.code. See Errors.