# Reading Rhythms data for agents

All files are generated on request from the same database as the site (cached up to 15 minutes). Schema version 1.0; fields are only added within a version.

## https://readingrhythms.co/agents/events.json

`{ schema_version, generated_at, source_ok, count, events: [...] }`. Each event:

- `id` (string), `title`, `url` (event page), `ticket_url` (Luma ticket page or null)
- `start`, `end` (ISO 8601 with offset, `end` may be null), `timezone` (IANA), `local_date`, `local_time` (as shown on the event page)
- `chapter`, `chapter_slug`, `city`, `region` (state or null), `country`, `area` ("New York City", "United States", a country, or "Online")
- `online` (boolean), `member_only` (boolean: booked with a Passport in the app; venue, price and ticket link are then null), `venue_name`, `venue_address`, `venue_type`, `venue_features` (array of strings), `neighborhood` (NYC neighborhood, or the venue's town when it differs from the city; may be null)
- `price_min`, `price_max` (numbers or null), `currency` (ISO 4217), `price_display` (as shown on event cards), `sold_out` (boolean)
- `summary` (plain text, up to 280 characters)

## https://readingrhythms.co/agents/chapters.json

`{ schema_version, generated_at, source_ok, count, chapters: [...] }`. Each chapter: `name`, `slug`, `city`, `region`, `country`, `area`, `upcoming_events` (number), `next_event` (ISO 8601 or null), `held_last_90_days` (public events held in the last 90 days, or null when unknown).

## https://readingrhythms.co/agents/cities/{city}.json

`{ schema_version, generated_at, source_ok, city: { slug, name, region, country, events_page, markdown }, passport: { listed, city_label, page, plans }, chapters: [...], count, events: [...] }`. Events and chapters use the fields above. The same facts as markdown: `/agents/cities/{city}.md`. The list of cities is in /agents/chapters.md.

`source_ok: false` means the database did not answer; the lists are then empty and the response is not cached.

## Other formats

- https://readingrhythms.co/events.json: JSON Feed 1.1
- https://readingrhythms.co/events.ics: iCalendar
- Event pages carry schema.org Event data (JSON-LD).
- Send `Accept: text/markdown` to https://readingrhythms.co/ or /events/ to get these pages as markdown.
