GET/v1/classes/slug/{slug}all plans

Retrieve a class by slug

Returns the same class as /v1/classes/{id}, addressed by slug instead of id.

slug is unique per (metro, type). If the key can see this slug in more than one metro, returns 400 with details.metros; pass metro= to disambiguate. include_archived=true returns an archived row.

Returns 503 when this endpoint is unavailable.

Try this requestRun it with sample data, no key needed. Paste a key to run it live.

Example request

curl -sS \
  -H "X-API-Key: $TAILEND_API_KEY" \
  "https://api.tailend.dev/v1/classes/slug/kids-pottery-classes-b3d835f7"

Example response · 200

{
  "data": {
    "id": "c57d9bae-6479-41c5-9176-f314fa4d31f4",
    "type": "class",
    "slug": "kids-pottery-classes-b3d835f7",
    "name": "Kids Pottery Classes",
    "description": "6-week pottery classes for kids ages 8-16, focusing on wheel-throwing and hand-building techniques.",
    "program": {
      "enrollment_type": "enrollment",
      "skill_level_notes": "all levels",
      "adult_participation": null,
      "what_youll_learn": null,
      "prerequisites": null
    },
    "term": {
      "name": null,
      "starts_on": "2026-09-29",
      "ends_on": "2026-12-15",
      "total_classes": null
    },
    "schedule": {
      "type": "session",
      "days": [
        "tuesday"
      ],
      "start_time": "16:00:00",
      "end_time": "18:00:00",
      "duration_minutes": 120,
      "is_recurring": true,
      "rrule": "FREQ=WEEKLY;BYDAY=TU",
      "notes": "Tuesdays (4:00 pm – 6:00 pm)",
      "timezone": "America/New_York"
    },
    "tuition": {
      "amount": 185,
      "from": 185,
      "text": "$185 for 6-week session",
      "drop_in_price": null,
      "trial_price": null,
      "trial_notes": null,
      "currency": "USD"
    },
    "price": {
      "type": "fixed",
      "min": 185,
      "max": 185,
      "scope": "admission",
      "note": "$185 for 6-week session",
      "unit": "per_session",
      "is_free": false,
      "currency": "USD"
    },
    "ages": {
      "min": 8,
      "max": 16,
      "text": "Early Elementary, Tweens, Teens",
      "audience": "kids",
      "bands": [
        "bigger_kids"
      ]
    },
    "audience": "teens",
    "traits": {
      "seasons": [
        "fall",
        "winter"
      ]
    },
    "place": {
      "id": "1af0824d-36cf-482d-a6d7-073343ae52ed",
      "slug": "earth-center-pottery-ebc6fdd7",
      "name": "Earth Center Pottery"
    },
    "location": {
      "address": "10 Stable Mill Trl, Richboro, PA 18954, USA",
      "street_address": "10 Stable Mill Trl, Richboro, PA 18954, USA",
      "city": "Richboro",
      "state": "PA",
      "zip": "18954",
      "lat": 40.2226282,
      "lng": -74.9866812,
      "neighborhood": "Somerton",
      "neighborhood_slug": "somerton"
    },
    "categories": [
      "arts_creative"
    ],
    "occasions": [],
    "registration": {
      "url": "https://www.cognitoforms.com/TylerParkCenterForTheArts/KidsPotteryClasses",
      "status": "open",
      "opens_at": null,
      "spots_remaining": null,
      "has_spots_available": true,
      "waitlist_available": false,
      "sections_with_spots": 1
    },
    "sections_total": 1,
    "sections": [
      {
        "id": "0b8a3f5e-52c4-4d64-9a0e-2f6d7c1e9a11",
        "name": "Tuesday afternoon",
        "schedule": {
          "days": [
            "tuesday"
          ],
          "start_time": "16:00:00",
          "end_time": "18:00:00",
          "duration_minutes": 120,
          "rrule": "FREQ=WEEKLY;BYDAY=TU",
          "notes": "Tuesdays (4:00 pm – 6:00 pm)",
          "timezone": "America/New_York"
        },
        "term": {
          "name": null,
          "starts_on": "2026-09-29",
          "ends_on": "2026-12-15",
          "total_classes": null
        },
        "ages": {
          "min": 8,
          "max": 16,
          "text": null
        },
        "tuition": {
          "amount": 185,
          "text": "$185 for 6-week session",
          "drop_in_price": null,
          "currency": "USD"
        },
        "registration": {
          "url": "https://www.cognitoforms.com/TylerParkCenterForTheArts/KidsPotteryClasses",
          "status": "open",
          "spots_remaining": null,
          "has_spots_available": true,
          "waitlist_available": false
        },
        "updated_at": "2026-09-26T12:01:08.782Z"
      }
    ],
    "sessions": [],
    "image_url": "https://earthcenterpottery.com/wp-content/uploads/2024/02/IMG_0318-scaled-e1707359564209-1024x566.jpg",
    "organization": {
      "id": "37bae48b-e86c-44a4-80d7-29fd9c34443c",
      "name": "Earth Center Pottery",
      "slug": "earthcenterpotterycom-f09a2fcc"
    },
    "confidence": 0.45,
    "verified_at": "2026-09-26T12:00:21.748Z",
    "metro": "philadelphia",
    "status": "published",
    "created_at": "2026-07-17T16:01:41.805Z",
    "updated_at": "2026-09-26T12:01:08.782Z",
    "links": {
      "self": "/v1/classes/c57d9bae-6479-41c5-9176-f314fa4d31f4",
      "place": "/v1/places/1af0824d-36cf-482d-a6d7-073343ae52ed",
      "organization": "/v1/organizations/37bae48b-e86c-44a4-80d7-29fd9c34443c"
    }
  }
}

API key Remember for this tab

Try any request with sample data, no key needed. Available on every plan.

slugstringrequiredpath

Listing slug — the segment a consumer already has in its own URLs.

Optional parameters (6)

metrostringoptionalquery

Which metro's row is meant, when a slug is not unique across the key's metros.

include_archivedbooleanoptionalquery

Also serve a listing whose status is archived — a permalink that should still render, with a "this has passed" banner, rather than 404.

fieldsarray of stringoptionalquery

Keep only these dotted paths on each item (name,place.name,price.is_free); id and type are always kept so a trimmed item stays addressable.

expandarray of stringoptionalquery

Attach the full Place and/or the Organization behind each item under expanded, one extra read per expansion per page (not per row).

includearray of stringoptionalquery

Opt into a block the lean default response leaves out.

include_modestringoptionalquery

How an include= the key is not entitled to is handled.

Response

A 200 returns application/json with these fields.

dataClassalways present
An enrollable program. A program that is offered as several variants (different days, age groups or terms) lists them in sections; its own schedule, term, ages and tuition remain the provider's headline values for the program.
- 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
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
The class
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.

Ctrl Enter to send

Request

GEThttps://api.tailend.dev/v1/classes/slug/kids-pottery-classes-b3d835f7

curl -sS \
  -H "X-API-Key: $TAILEND_API_KEY" \
  "https://api.tailend.dev/v1/classes/slug/kids-pottery-classes-b3d835f7"

const res = await fetch("https://api.tailend.dev/v1/classes/slug/kids-pottery-classes-b3d835f7", {
  headers: { 'X-API-Key': '$TAILEND_API_KEY' },
});
const body = await res.json();
console.log(res.status, body);

import os
import requests

response = requests.get(
    "https://api.tailend.dev/v1/classes/slug/kids-pottery-classes-b3d835f7",
    headers={'X-API-Key': os.environ['TAILEND_API_KEY']},
)
response.raise_for_status()
print(response.json())

ResponseSample

Showing sample data. Paste a key to run it live. Get a key

The class

{
  "data": {
    "id": "c57d9bae-6479-41c5-9176-f314fa4d31f4",
    "type": "class",
    "slug": "kids-pottery-classes-b3d835f7",
    "name": "Kids Pottery Classes",
    "description": "6-week pottery classes for kids ages 8-16, focusing on wheel-throwing and hand-building techniques.",
    "program": {
      "enrollment_type": "enrollment",
      "skill_level_notes": "all levels",
      "adult_participation": null,
      "what_youll_learn": null,
      "prerequisites": null
    },
    "term": {
      "name": null,
      "starts_on": "2026-09-29",
      "ends_on": "2026-12-15",
      "total_classes": null
    },
    "schedule": {
      "type": "session",
      "days": [
        "tuesday"
      ],
      "start_time": "16:00:00",
      "end_time": "18:00:00",
      "duration_minutes": 120,
      "is_recurring": true,
      "rrule": "FREQ=WEEKLY;BYDAY=TU",
      "notes": "Tuesdays (4:00 pm – 6:00 pm)",
      "timezone": "America/New_York"
    },
    "tuition": {
      "amount": 185,
      "from": 185,
      "text": "$185 for 6-week session",
      "drop_in_price": null,
      "trial_price": null,
      "trial_notes": null,
      "currency": "USD"
    },
    "price": {
      "type": "fixed",
      "min": 185,
      "max": 185,
      "scope": "admission",
      "note": "$185 for 6-week session",
      "unit": "per_session",
      "is_free": false,
      "currency": "USD"
    },
    "ages": {
      "min": 8,
      "max": 16,
      "text": "Early Elementary, Tweens, Teens",
      "audience": "kids",
      "bands": [
        "bigger_kids"
      ]
    },
    "audience": "teens",
    "traits": {
      "seasons": [
        "fall",
        "winter"
      ]
    },
    "place": {
      "id": "1af0824d-36cf-482d-a6d7-073343ae52ed",
      "slug": "earth-center-pottery-ebc6fdd7",
      "name": "Earth Center Pottery"
    },
    "location": {
      "address": "10 Stable Mill Trl, Richboro, PA 18954, USA",
      "street_address": "10 Stable Mill Trl, Richboro, PA 18954, USA",
      "city": "Richboro",
      "state": "PA",
      "zip": "18954",
      "lat": 40.2226282,
      "lng": -74.9866812,
      "neighborhood": "Somerton",
      "neighborhood_slug": "somerton"
    },
    "categories": [
      "arts_creative"
    ],
    "occasions": [],
    "registration": {
      "url": "https://www.cognitoforms.com/TylerParkCenterForTheArts/KidsPotteryClasses",
      "status": "open",
      "opens_at": null,
      "spots_remaining": null,
      "has_spots_available": true,
      "waitlist_available": false,
      "sections_with_spots": 1
    },
    "sections_total": 1,
    "sections": [
      {
        "id": "0b8a3f5e-52c4-4d64-9a0e-2f6d7c1e9a11",
        "name": "Tuesday afternoon",
        "schedule": {
          "days": [
            "tuesday"
          ],
          "start_time": "16:00:00",
          "end_time": "18:00:00",
          "duration_minutes": 120,
          "rrule": "FREQ=WEEKLY;BYDAY=TU",
          "notes": "Tuesdays (4:00 pm – 6:00 pm)",
          "timezone": "America/New_York"
        },
        "term": {
          "name": null,
          "starts_on": "2026-09-29",
          "ends_on": "2026-12-15",
          "total_classes": null
        },
        "ages": {
          "min": 8,
          "max": 16,
          "text": null
        },
        "tuition": {
          "amount": 185,
          "text": "$185 for 6-week session",
          "drop_in_price": null,
          "currency": "USD"
        },
        "registration": {
          "url": "https://www.cognitoforms.com/TylerParkCenterForTheArts/KidsPotteryClasses",
          "status": "open",
          "spots_remaining": null,
          "has_spots_available": true,
          "waitlist_available": false
        },
        "updated_at": "2026-09-26T12:01:08.782Z"
      }
    ],
    "sessions": [],
    "image_url": "https://earthcenterpottery.com/wp-content/uploads/2024/02/IMG_0318-scaled-e1707359564209-1024x566.jpg",
    "organization": {
      "id": "37bae48b-e86c-44a4-80d7-29fd9c34443c",
      "name": "Earth Center Pottery",
      "slug": "earthcenterpotterycom-f09a2fcc"
    },
    "confidence": 0.45,
    "verified_at": "2026-09-26T12:00:21.748Z",
    "metro": "philadelphia",
    "status": "published",
    "created_at": "2026-07-17T16:01:41.805Z",
    "updated_at": "2026-09-26T12:01:08.782Z",
    "links": {
      "self": "/v1/classes/c57d9bae-6479-41c5-9176-f314fa4d31f4",
      "place": "/v1/places/1af0824d-36cf-482d-a6d7-073343ae52ed",
      "organization": "/v1/organizations/37bae48b-e86c-44a4-80d7-29fd9c34443c"
    }
  }
}

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.

{
  "error": {
    "code": "bad_request",
    "message": "radius_m: must be at least 100",
    "details": {
      "param": "radius_m"
    },
    "request_id": "req_dfbc3295a8382b05"
  }
}

Missing, unknown or revoked X-API-Key.

{
  "error": {
    "code": "unauthorized",
    "message": "missing X-API-Key header",
    "request_id": "req_90e63908273f6bff"
  }
}

Two different reasons share this status.

{
  "error": {
    "code": "forbidden",
    "message": "key is not scoped to metro 'boston'",
    "details": {
      "metros": [
        "philadelphia"
      ]
    },
    "request_id": "req_9e7a750acef48ab2"
  }
}

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

{
  "error": {
    "code": "not_found",
    "message": "unknown metro 'boston'",
    "request_id": "req_7431b51e10ec2b77"
  }
}

The path exists; the method does not.

{
  "error": {
    "code": "method_not_allowed",
    "message": "POST is not allowed on this path; this API is read-only",
    "details": {
      "allow": [
        "GET",
        "HEAD",
        "OPTIONS"
      ]
    },
    "request_id": "req_01J9Z3"
  }
}

A limit was reached.

{
  "error": {
    "code": "rate_limited",
    "message": "3 requests per minute exceeded",
    "request_id": "req_06bfd3c2d5e8aa9f"
  }
}

A bug on our side.

{
  "error": {
    "code": "internal",
    "message": "internal error",
    "request_id": "req_01J9Z3"
  }
}

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

{
  "error": {
    "code": "not_implemented",
    "message": "this endpoint is not enabled on this deployment; it is not a fault and retrying will not help",
    "request_id": "req_01J9Z3"
  }
}

A transient outage: a dependency could not be reached or did not answer in time.

{
  "error": {
    "code": "unavailable",
    "message": "the service is temporarily unable to serve this request; retry after the interval in Retry-After",
    "request_id": "req_01J9Z3"
  }
}