Developer documentation

The REST API and MCP server let organizers read and manage events, ticket tiers, attendees, orders, check-in, and refunds. They are free on every plan.

Get an API key

Organizers can create keys at API Access. A key is shown once; choose scopes, set an optional expiry, and revoke it there. High-risk scopes are unchecked by default.

Authentication

Send the key in the Bearer authorization header.

curl -H "Authorization: Bearer tp_YOUR_API_KEY" https://www.ticketplace.vip/api/v1/account

Base URL: https://www.ticketplace.vip/api/v1

Scopes

Scope	Access	Account	Enabled by default
`events:read`	Read organizer account and events	Organizer	Yes
`events:write`	Create and edit events	Organizer	Yes
`attendees:read`	Read attendees and orders	Organizer	Yes
`checkin:write`	Redeem tickets	Organizer	Yes
`payments:write`	Refund orders	Organizer	No
`delete`	Delete photos or deactivate events	Organizer	No

Safety and limits

Write operations that change data use preview/confirm where supported.
Use Idempotency-Key for safe retries of supported writes.
Rate limit: 60 requests per minute per API key.
Daily cap: 20 confirmed refunds per organizer.
API requests are audit-logged without request or response bodies.
Human-only actions not in the API: coupons, attendee messaging, per-date add/remove, featured events, venue editing, Stripe Connect onboarding and payouts, API-key management, password changes, and account deletion.

Pagination and errors

List endpoints use limit and cursor where documented. Responses include next_cursor when another page is available. Errors use an error object; validation details may also be returned in errors.

{
  "error": {
    "code": "validation_error",
    "message": "The request could not be processed."
  },
  "errors": { "name": "This field is required." }
}

REST endpoint reference

Generated from the current OpenAPI document at request time. See OpenAPI 3.1 JSON.

Account

Method	Path	Summary	Scope
GET	`/account`	Get the authenticated organizer profile	`events:read`

Events

Method	Path	Summary	Scope
GET	`/events`	List the authenticated organizer's events	`events:read`
POST	`/events`	Create a complete draft event	`events:write`
GET	`/events/{event_id}`	Get an organizer-owned event	`events:read`
PATCH	`/events/{event_id}`	Update editable event details	`events:write`
POST	`/events/{event_id}/deactivate`	Preview or deactivate an event	`events:write + delete`
POST	`/events/{event_id}/photos`	Upload an event photo	`events:write`
DELETE	`/events/{event_id}/photos/{photo_id}`	Preview or delete an event photo	`events:write + delete`
POST	`/events/{event_id}/publish`	Preview or publish an event	`events:write`
PATCH	`/events/{event_id}/tiers/{tier_id}`	Update ticket tier details and price	`events:write`

Attendees

Method	Path	Summary	Scope
GET	`/events/{event_id}/attendees`	List attendees for an owned event	`attendees:read`

Orders

Method	Path	Summary	Scope
POST	`/check-in`	Redeem a ticket	`checkin:write`
GET	`/orders/{purchase_id}`	Get an organizer-owned order	`attendees:read`
POST	`/orders/{purchase_id}/refund`	Preview or refund an order	`payments:write`

MCP

MCP URL: https://www.ticketplace.vip/mcp

Available tools: get_account, list_events, get_event, create_event_draft, update_event, update_ticket_tier, upload_event_photo, delete_event_photo, publish_event, deactivate_event, list_attendees, get_order, check_in_ticket, refund_order.

Cursor

{
   "mcpServers" : {
      "ticket-place" : {
         "headers" : {
            "Authorization" : "Bearer tp_YOUR_API_KEY"
         },
         "url" : "https://www.ticketplace.vip/mcp"
      }
   }
}

Claude Code

claude mcp add --transport http ticket-place https://www.ticketplace.vip/mcp --header "Authorization: Bearer tp_YOUR_API_KEY"

Syntax: Claude Code MCP documentation.

Claude Desktop

Using the mcp-remote stdio bridge:

{
   "mcpServers" : {
      "ticket-place" : {
         "args" : [
            "-y",
            "mcp-remote",
            "https://www.ticketplace.vip/mcp",
            "--header",
            "Authorization: Bearer tp_YOUR_API_KEY"
         ],
         "command" : "npx"
      }
   }
}

To connect from ChatGPT or claude.ai, add this MCP URL as a custom connector, then sign in to approve access. OAuth does not require an API key.