> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fesutibaru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Public listings

> Your public events, people and venues, for your website.

Your website, or the Fesutibaru WordPress plugin, reads your **public** listings with an API key: the events marked public in the current edition, the people appearing in them, and your venues. Keys can only read what's public, and can't change anything.

An administrator makes a key in Planner under **Admin → API**. It's shown once: keep it secret, on your server, never in a web page.

```bash theme={null}
curl https://demo.fesutibaru.com/api/v1/public/events \
  -H "Authorization: Bearer fstb_…"
```

| Endpoint | Gives |
| - | - |
| `GET /api/v1/public/events` | Public events: `?page`, `?per_page` (up to 200), `?search`, `?date`, `?venue`, `?event_type`, and accessibility filters (`bsl_interpreted`, `captioned`, `subtitled`, `audio_described`, `relaxed_performance`) |
| `GET /api/v1/public/events/<id>` | One public event |
| `GET /api/v1/public/people` | People appearing in public events |
| `GET /api/v1/public/people/<id>` | One person |
| `GET /api/v1/public/venues` | Your venues |

Listings use their own field names (`startTime`, `imageUrl`), and are limited to 100 requests a minute per key.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.