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

# Changelog

> Version history for the Ticketnation Open API and SDK.

## ticketnation-mcp v1.0.0 — March 2026

**MCP server for AI agents.** Connect Claude, Cursor, or any MCP-compatible AI to the Ticketnation API.

* 21 tools: events, tickets, performers, schedules, brands, orders, venues, webhooks
* Works with Claude Desktop, Claude Code, and Cursor
* Uses `ticketnation-sdk` internally
* Setup: `npx -y ticketnation-mcp` with `TICKETNATION_API_KEY` env var

See [MCP Server docs](/developers/mcp) for setup instructions.

***

## v1.1.0 — March 2026

**New resources, DX improvements, and the error hint system.**

### New Resources

<CardGroup cols={3}>
  <Card title="Performers" icon="microphone">
    Add artists, DJs, speakers, and hosts to your event lineup
  </Card>

  <Card title="Schedules" icon="clock">
    Build timetables with time slots linked to performers
  </Card>

  <Card title="Brands" icon="star">
    Attach sponsor and partner brands to your events
  </Card>
</CardGroup>

* **Performers** — `tn.performers.create()`, `tn.performers.list()`, `tn.performers.remove()`
* **Schedules** — `tn.schedules.create()`, `tn.schedules.list()`, `tn.schedules.update()`, `tn.schedules.remove()`
* **Brands** — `tn.brands.create()`, `tn.brands.list()`, `tn.brands.remove()`

### New REST Endpoints

* `POST /events/:eventId/performers` — Add a performer
* `GET /events/:eventId/performers` — List performers
* `DELETE /events/:eventId/performers/:performerId` — Remove a performer
* `POST /events/:eventId/schedules` — Create a schedule entry
* `GET /events/:eventId/schedules` — List schedule entries
* `PATCH /events/:eventId/schedules/:scheduleId` — Update a schedule entry
* `DELETE /events/:eventId/schedules/:scheduleId` — Remove a schedule entry
* `POST /events/:eventId/brands` — Add a brand
* `GET /events/:eventId/brands` — List brands
* `DELETE /events/:eventId/brands/:brandId` — Remove a brand

### Event Enhancements

* **`imageUrl`** — Set a cover image when creating or updating events
* **`galleryUrls`** — Attach an array of gallery images to events
* **`createAndPublish()`** — New SDK helper that creates and publishes an event in a single call

### DX Improvements

* **`formatPeso()`** utility — Format numbers as Philippine Peso strings (`formatPeso(1500)` returns `"₱1,500.00"`, `formatPeso(0)` returns `"Free"`)
* **`validatePrice()`** utility — Validate price values before sending to the API
* **Error hints** — All error responses now include a `hint` field with actionable guidance for resolving the issue

### Price Format Change

<Warning>
  Prices are now in **whole pesos**, not centavos. `price: 1500` means **₱1,500.00**. Update your integration if you were using centavo values.
</Warning>

***

## v1.0.0 — March 2026

**Initial release of the Ticketnation Open API and TypeScript SDK.**

### Open API v1

* **Events**: Create, list, get, update, publish, unpublish, archive, delete
* **Tickets**: Create, list, get, update, publish, mark sold out, delete
* **Orders**: List event orders, get order details
* **Venues**: Search public venues by name
* **Webhooks**: Create, list, update, delete, test, delivery history
* **Account**: Get API key and organization info (`/me`)

### ticketnation-sdk v1.0.0

* TypeScript SDK with full type safety
* ESM + CJS dual output
* Automatic retry on 5xx errors with exponential backoff
* Debug mode with redacted API key logging
* Pagination helpers (`paginate`, `fetchAllPages`)
* Zero runtime dependencies (uses native `fetch`)

### Authentication

* API key authentication via `api-key` header
* 6 scopes: `events:read`, `events:write`, `tickets:read`, `tickets:write`, `orders:read`, `webhooks:manage`
* IP allowlist support
* Webhook HMAC signature verification

### Rate Limits

* Three tiers: Free (60/min), Pro (300/min), Enterprise (1000/min)
* Rate limit headers on all responses