Skip to content
tailendAPI
OpenAPIGet an API key
GET/v1/organizations/{id}/eventsall plans

List organization events

Same as GET /v1/{metro}/events?organization_id={id}, addressed by the organization instead of the metro.

Show more

Resolves the organization by id, 404s if it does not exist, and takes the metro from that row. An organization with live listings in more than one metro is a 400 asking for metro= to disambiguate, exactly like a slug that is not unique across the key's metros; give it and the ambiguity is resolved the same way. Every other list parameter keeps working. Same auth, metro scope, rate limiting and metering as the list endpoint; a key without access to the organization's metro gets the same 403 the list endpoint gives.

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/organizations/b81a95d2-1d4e-46fd-9cff-322a41e429ad/events"
Example response · 200
{
  "data": [
    {
      "id": "b81a95d2-1d4e-46fd-9cff-322a41e429ad",
      "type": "event",
      "slug": "toddler-time-ages-5-and-under-toddler-time-observer-e50d61ea",
      "name": "Toddler Time (Ages 5 and Under) / Toddler Time Observer",
      "description": "Includes Treehouses and Free Play Areas for toddlers ages 5 and under.",
      "starts_local": "2026-09-14T09:30:00",
      "ends_local": null,
      "start_time": "09:30:00",
      "has_time": true,
      "has_date": true,
      "all_day": false,
      "timezone": "America/New_York",
      "starts_at": "2026-09-14T13:30:00.000Z",
      "ends_at": null,
      "is_recurring": true,
      "rrule": "FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR",
      "recurrence_description": null,
      "place": {
        "id": "9cde4494-6c2a-4bfc-b15a-22edce13f3f7",
        "slug": "treehouse-world-d34361f7",
        "name": "Treehouse World"
      },
      "location": {
        "address": "1442 Phoenixville Pike, West Chester, PA 19380, USA",
        "street_address": "1442 Phoenixville Pike, West Chester, PA 19380, USA",
        "city": "West Chester",
        "state": "PA",
        "zip": "19380",
        "lat": 40.0240296,
        "lng": -75.5858949,
        "neighborhood": "Newtown Square",
        "neighborhood_slug": "newtown-square"
      },
      "price": {
        "type": "fixed",
        "min": 12,
        "max": 12,
        "scope": "admission",
        "note": "$12.00",
        "unit": "per_session",
        "is_free": false,
        "currency": "USD"
      },
      "ages": {
        "min": 1,
        "max": 5,
        "text": null,
        "audience": "kids",
        "bands": [
          "baby",
          "toddler",
          "young_kids"
        ]
      },
      "audience": "kids",
      "traits": {
        "seasons": [
          "fall"
        ]
      },
      "categories": [
        "social_play_spaces"
      ],
      "occasions": [],
      "teams": [],
      "registration_url": "https://treehouseworld.com/pages/admission-prices",
      "ticket_url": null,
      "registration_required": false,
      "is_sold_out": false,
      "image_url": null,
      "organization": {
        "id": "c45b9b3a-45ab-4f9c-b2e2-986dcb921f25",
        "name": "Treehouse World",
        "slug": "treehouseworldcom-a86bfd79"
      },
      "confidence": 1,
      "verified_at": "2026-09-26T14:06:38.332Z",
      "metro": "philadelphia",
      "status": "published",
      "created_at": "2026-09-14T08:04:04.969Z",
      "updated_at": "2026-09-26T14:06:38.788Z",
      "links": {
        "self": "/v1/events/b81a95d2-1d4e-46fd-9cff-322a41e429ad",
        "place": "/v1/places/9cde4494-6c2a-4bfc-b15a-22edce13f3f7",
        "organization": "/v1/organizations/c45b9b3a-45ab-4f9c-b2e2-986dcb921f25"
      }
    }
  ],
  "meta": {
    "limit": 1,
    "count": 1,
    "has_more": false,
    "applied_filters": {
      "from": "2026-09-14",
      "to": "2026-10-14",
      "min_confidence": 0.7,
      "audience": [
        "not_adults"
      ]
    },
    "defaults_applied": [
      "from",
      "to",
      "min_confidence",
      "audience"
    ]
  }
}

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

Listing id.

Optional parameters (38)

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

Local calendar date (metro timezone), inclusive.

Local calendar date (metro timezone), inclusive; at most 366 days after from.

Drop rows whose confidence is below this.

Keep rows whose categories contain any of these.

Keep rows whose audience is one of these.

Events, classes and camps only.

Events and classes tagged for a seasonal occasion.

Events built around a local pro sports team (watch parties, game-day themed events, team or mascot appearances).

A child's age in years.

Neighborhood slug or free-text name (case-insensitive).

Center latitude for a radius search.

Center longitude for a radius search.

Radius in metres around lat/lng (or near_zip, where enabled).

Beta — may not be enabled for all keys yet.

Beta — may not be enabled for all keys yet.

Beta — may not be enabled for all keys yet.

Keep rows held at this place (place.id).

Events, classes, and camps only; ignored for places.

true keeps only events with a stated clock time.

Filter on is_recurring.

Filter on is_indoor, a fact about the linked place.

Filter on is_outdoor, a fact about the linked place.

Filter on is_sensory_friendly (on events and classes, the linked place's; on places, the place's own).

Sync mode.

Full-text search over the listing's name and search text (websearch syntax: storytime park, "drop in", art -camp).

Keep rows on any of these local days.

Local start time at or after this, HH:MM (or HH:MM:SS).

Local start time strictly before this, HH:MM; 09:00–12:00 is the morning and 12:00 belongs to the afternoon.

A budget.

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.

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

Opt into a block the lean default response leaves out.

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

Opaque cursor from meta.next_cursor.

1-based page number (browse mode).

Counts over every listing that matches the filters, not just this page, returned as a top-level facets object beside data and meta.

Items per page, 1 to 200.

Ctrl Enter to send