# Overview

> What the Tailend API returns, who it is for, and a working request for each common job.

Source: https://api.tailend.dev/docs

The Tailend API returns family activities as clean JSON: **events**,
**classes**, **camps**, **places** and the **organizations** behind them,
for each metro we cover. It is read-only, every request is a plain HTTPS
`GET` with an API key, and no SDK is needed.

Use it to power a family app or website, a newsletter, a map, or an AI
assistant that needs to answer "what can we do this weekend?" with real,
current listings.

## Examples

Pick a job to see the request. Every example opens in the API reference, ready to try.

### Events this weekend

Dated events for a 4-year-old over two days. Reference: [List events](https://api.tailend.dev/docs/api/list-events.md)

```bash
curl -sS \
  -H "X-API-Key: $TAILEND_API_KEY" \
  "https://api.tailend.dev/v1/philadelphia/events?from=2026-10-17&to=2026-10-18&age=4"
```

### Search everything

One query across events, classes, camps and places. Reference: [Search every listing collection](https://api.tailend.dev/docs/api/search-listings.md)

```bash
curl -sS \
  -H "X-API-Key: $TAILEND_API_KEY" \
  "https://api.tailend.dev/v1/philadelphia/search?q=toddler%20story%20time&age=3"
```

### Classes starting soon

Classes whose term starts next week, for a 6-year-old. Reference: [List classes](https://api.tailend.dev/docs/api/list-classes.md)

```bash
curl -sS \
  -H "X-API-Key: $TAILEND_API_KEY" \
  "https://api.tailend.dev/v1/philadelphia/classes?starts_from=2026-10-19&starts_to=2026-10-25&age=6"
```

### A month at a glance

How many events start on each day, for a calendar view. Reference: [Event counts per day](https://api.tailend.dev/docs/api/get-event-calendar.md)

```bash
curl -sS \
  -H "X-API-Key: $TAILEND_API_KEY" \
  "https://api.tailend.dev/v1/philadelphia/events/calendar?from=2026-11-01&to=2026-11-30"
```

### Around an address

What is near an address, grouped the way people read a neighborhood. Reference: [Search around an address](https://api.tailend.dev/docs/api/search-around-address.md)

```bash
curl -sS \
  -H "X-API-Key: $TAILEND_API_KEY" \
  "https://api.tailend.dev/v1/philadelphia/around?address=1500%20Market%20St%2C%20Philadelphia%2C%20PA"
```

### Preview the planned change-feed request (Sync pilot)

The planned request for every change since an instant, removals included. Reference: [List changes](https://api.tailend.dev/docs/api/list-changes.md)

```bash
curl -sS \
  -H "X-API-Key: $TAILEND_API_KEY" \
  "https://api.tailend.dev/v1/changes?since=2026-10-01T00%3A00%3A00Z&metro=philadelphia"
```


## What you get back

Every listing has a stable `id` and `slug`, a `type`, local and UTC times,
ages, price and the place it happens at. Lists come in one envelope:

```json
{
  "data": [{ "id": "b81a95d2-…", "type": "event", "name": "Toddler Time", "starts_at": "2026-09-14T13:30:00.000Z" }],
  "meta": { "limit": 50, "count": 1, "has_more": false, "next_cursor": null }
}
```

- **Events** are dated occurrences. A weekly series is one listing; see
  [Recurring events](https://api.tailend.dev/docs/recurring-events.md).
- **Classes** are enrollable programs with a term, a schedule and tuition.
- **Camps** are camps and their dated, priced sessions.
- **Places** are venues with hours, admission and what they offer.
- **Organizations** run the listings and the places.

## How the docs are organized

- **[Quickstart](https://api.tailend.dev/docs/quickstart.md)**: a key, a first request, filters and the
  next page.
- **[API reference (try it)](https://api.tailend.dev/docs/api.md)**: every endpoint, parameter, field
  and status code, generated from the [OpenAPI spec](https://api.tailend.dev/docs/openapi.json).
  Try any request with sample data, no key needed.
- **[Changelog](https://api.tailend.dev/docs/changelog.md)**: what changed, with dates. Also as RSS.

Building with an AI coding agent? Point it at
[`/llms.txt`](https://api.tailend.dev/llms.txt); every page is also available as Markdown. See
[Build with AI agents](https://api.tailend.dev/docs/agents.md).