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

# v0.1.17 — November 9, 2026

> Batch event lookup and WebSocket event and market status notifications

## Batch event lookup

Fetch up to **50 events** with repeated `eventIds` parameters on
`GET /v1/pm/events`:

```bash theme={null}
curl --fail-with-body -sS \
  'https://relay.bayse.markets/v1/pm/events?eventIds=124d50eb-0d25-4026-a5f3-69df51768517&eventIds=06ec1292-f1c8-4387-928c-ed396946956f'
```

* Matching events follow your requested ID order.
* `missingEventIds` identifies unavailable or filtered-out events.
* Invalid UUIDs, duplicate IDs, and batches larger than 50 are rejected.
* Batch requests ignore pagination limits; other filters still apply.
* The default status filter includes open and paused events. Set the status
  explicitly to retrieve closed or resolved events.

See [List events](https://docs.bayse.markets/api-reference/pm/list-events.md#fetch-multiple-events-by-id) for
request and response examples.

## Event and market status notifications

Subscribe to `lifecycle` on `wss://socket.bayse.markets/ws/v1/markets` to receive
status changes for events and their child markets. No authentication is required.

```json theme={null}
{
  "type": "subscribe",
  "channel": "lifecycle",
  "eventIds": ["124d50eb-0d25-4026-a5f3-69df51768517"]
}
```

* Use `eventIds` for 1–50 IDs per request, or `eventId` for a single event.
* `event.status_changed` identifies a parent event status change.
* `market.status_changed` includes both `eventId` and `marketId`. Child markets
  can change independently while the parent event stays open.
* Lifecycle WebSocket events are typically delayed by up to one minute and
  carry the latest status change for each entity.

See [Event and market status](https://docs.bayse.markets/websocket/event-status.md) for payloads, unsubscribe
requests, and client examples.


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