Muzeek Events and Tours API
REST APIs for reading and managing shows and tours in your Muzeek account from any server-side application.
Events, event catalogs, event items, tour catalogs, tours, and Ticket Reports are the REST resources on this page. Additional REST APIs will be published here as they become available. If you have a use case that isn't covered yet, we'd love to hear from you.
Machine-readable OpenAPI 3.1: https://muzeek.ai/openapi.json.
Base URL
All endpoints are served from:
https://muzeek.ai/apiRequests and responses are JSON. All timestamps are ISO 8601 in UTC. All resource identifiers exposed through the external API are UUIDs.
Authentication
Every request to the Muzeek API is authenticated with an API key. Pass it as Authorization: Bearer or as the X-API-Key HTTP header.
curl https://muzeek.ai/api/events \
-H "Authorization: Bearer mzk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Equivalent header:
curl https://muzeek.ai/api/events \
-H "X-API-Key: mzk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"Generating a key. Open Settings → API & MCP, create an API client, and generate a key. Grant each key the minimum scopes it needs. A key is for scripts and apps. To connect an assistant, use Connect.
One-time display. Your key is shown only once at the moment it is created. Copy it to your secret manager straight away — it cannot be displayed or recovered again.
Rotation & revocation. You can rotate or revoke keys at any time from the same screen. Revoked keys stop working immediately.
Never send keys in the URL. Always pass keys in a header. Keys sent as query-string parameters can leak through server logs, browser history, caches, and Referer headers, so the API rejects them.
Connect
Sign in when an assistant should work in an Account. Create a key when a script or app sends the key itself.
An assistant
- Paste
https://muzeek.ai/mcpin the assistant. - Sign in.
- Pick the Account.
- Come back to the assistant.
Use MCP for agents that don't have a direct Muzeek AI plugin or connection available in our Integrations page. Some agents such as Claude, ChatGPT, Gemini, and Copilot can connect directly from Integrations.
That connection works on the Account you picked. It can look up and change events, schedule items on those events, Profit & Loss, and tours there.
A script or app
Create a client and key under Settings → API & MCP. Poly and other programs that send a key use this path. API keys shows how to send the key.
MCP
Assistants and scripts call Muzeek over Streamable HTTP. Tool results are JSON. The public URL is:
https://muzeek.ai/mcpAn assistant signs in with the steps in Connect. A script or app sends an API key with Authorization: Bearer or X-API-Key.
API key example for a script or app:
{
"mcpServers": {
"muzeek": {
"url": "https://muzeek.ai/mcp",
"headers": {
"Authorization": "Bearer mzk_live_your_api_key_here"
}
}
}
}GET /api/me returns the same account and connection as whoami. A signed-in session or an API key can call it. An API key does not need a scope. GET /api/users/me is the signed-in person and stays session-only.
{
"account": { "id": "<account uuid>", "name": "Account name" },
"connection": { "type": "api_key", "name": "Key name", "id": "<client uuid>" },
"permissions": ["read:events"]
}connection.id is the API client id, and only when the caller is an API key. A session uses type: "session" and an empty permissions list. OAuth whoami uses type: "oauth" and ["*"].
MCP requests share the standard API-key hourly window (1,000 requests) and the same X-RateLimit-* headers as the REST API.
Initialize advertises tools.listChanged: true. Streamable HTTP POST responses can include notifications/tools/list_changed so clients refresh tools/list without reconnecting. Assistants that only snapshot tools at connect still need a new session after a deploy.
MCP tools
The allowlist matches API key scopes, plus whoami. Resource identifiers are UUIDs.
whoamiaccountReturn the authenticated account and this connection's permissions.
searchEventseventsSearch events. Requires read:events on an API key.
getEventeventsRetrieve one event by UUID, including schedule items on that event. Pass include=financials for Profit & Loss (same as GET /api/events/:id?include=financials). Dedicated getEventFinancials returns the full P&L bundle. Pass include=lineup for Event → Lineup (same as GET /api/events/:id?include=lineup). Dedicated getEventLineup returns the full bill. Returns typeSpecificData (Show Details, including custom and _ui.customFields) and privateReportingData (Reporting). Requires read:events. Does not return ticket reports, venueContactId, or public share tokens/URLs (ticket report, runsheet, Profit & Loss) on the event or nested tour.
createEventeventsCreate a show. startDate is required (ISO datetime or yyyy-MM-dd). Title, endDate, timezone, and isAllDay are optional — omitted title becomes No Event Title. A sent start time is kept and only missing end, timezone, and isAllDay are filled. A calendar day (yyyy-MM-dd) gets default clocks from Edit Event Type, then Settings → Events, then 8:00 pm–10:00 pm, or all-day when the type has blank time. Omit status to start as private and unpublished, then reconciliation may still apply. Call listEventStatuses, listEventLabels, and listEventTypes for valid keys. listEventTypes now includes Show Details field definitions. labelKeys replaces the set. tourId attaches the show to a tour. venueId and venueContactId are mutually exclusive (UUID from the app; no contacts list). Image URLs (imageUrl) stay on REST create, not this tool. description is public copy. Do not put internal or private notes there. Show Details custom fields use typeSpecificData: built-in keys from listEventTypes fields, extras in custom[key] with definitions in _ui.customFields. Those fields show in the event panel and can appear on runsheets. Notes that must stay off runsheets and offers go in privateReportingData (Reporting), not description and not typeSpecificData. Requires write:events.
updateEventeventsChange a show. Set the title, dates, status, labels, published state, event type, place, venue, or tour. Pass status and/or isPublished. Call listEventStatuses, listEventLabels, and listEventTypes for valid keys. labelKeys replaces the set. Pass the show id. tourId attaches the show to a tour. A null tourId takes the show off. venueId and venueContactId are mutually exclusive. Image URLs (imageUrl) stay on REST update, not this tool. description is public copy — do not put internal notes there. Show Details: typeSpecificData (custom[key] plus _ui.customFields). Shallow-merge with getEvent first. Internal notes that must stay off runsheets: privateReportingData (full replace — getEvent first and merge). Requires write:events.
deleteEventeventsRemove a show from the account, including linked bookings and schedule items. Later GET calls return 404. Requires write:events. No confirm flag.
listEventStatuseseventsList event statuses this Account can pick for new shows. Requires read:events.
createEventStatuseventsAdd a custom event status (for example TBC). Omitting publishesEvent still publishes shows, matching Settings. publishesEvent and showOnEventList (including that default) need an Account admin. Requires write:events.
updateEventStatuseventsRename or recolor an event status. Pass id from listEventStatuses. Requires write:events.
deleteEventStatuseventsRemove an event status from new picks. Existing shows keep the key. Requires write:events.
listEventLabelseventsList event labels this Account can put on shows. These are not tour types. Requires read:events.
createEventLabeleventsAdd a custom event label (for example headline, support, festival, instore). Requires write:events.
updateEventLabeleventsRename or recolor an event label. Requires write:events.
deleteEventLabeleventsRemove an event label from new picks. Requires write:events.
listEventTypeseventsList macro event types this Account can pick for shows (show, travel, day_off, plus custom macro types). Each row includes fields (Show Details keys, labels, and types) and defaultFieldValues from Settings. Put those values on createEvent/updateEvent typeSpecificData. Extra per-show fields go in typeSpecificData.custom with definitions in typeSpecificData._ui.customFields. Reporting (privateReportingData) is a separate blob and is not listed here. Schedule-item types are listEventItemTypes, not this list. Hidden and removed types are omitted. Requires read:events.
createEventTypeeventsAdd a custom macro event type. Requires write:events.
updateEventTypeeventsRename or restyle a macro event type. Requires write:events.
deleteEventTypeeventsRemove a macro event type from new picks. Requires write:events.
searchEventItemseventsList schedule items. Pass eventId to nest under a show. Requires read:events.
getEventItemeventsRetrieve one schedule item by UUID. Requires read:events.
listEventItemTypeseventsList the schedule-item types this Account can pick, including field definitions for typeSpecificData and id for catalog writes. Accounts can rename or delete system-provided types. Requires read:events.
createEventItemTypeeventsAdd a custom schedule-item type. Requires write:events.
updateEventItemTypeeventsRename or restyle a schedule-item type. Pass id from listEventItemTypes. Requires write:events.
deleteEventItemTypeeventsRemove a schedule-item type from new picks. Requires write:events.
createEventItemeventsCreate a schedule item on an existing event. itemType must be a typeKey from listEventItemTypes. Times use ISO startDate and endDate. Set typeSpecificData using that list's field keys. Requires write:events.
updateEventItemeventsChange a schedule item. Same fields as create. Pass the item id. Requires write:events.
deleteEventItemeventsRemove a schedule item from the account. Later GET calls return 404. Requires write:events.
completeEventItemTaskeventsMark a schedule-item task complete or incomplete. Requires write:events.
getEventFinancialseventsReturn Profit & Loss for one event: Projected and Actual sections, line items, and server totals. Same JSON as GET /api/events/:id/financials, including the { data } wrap. Amounts and totals are numbers (not decimal strings). Pass scenario actual, projected, or both (default both). Requires read:events. Does not return share tokens.
createEventFinancialSectioneventsAdd a Profit & Loss section on an event. Pass the event id, scenario (actual or projected), name, and type (revenue or cost). Same as POST /api/events/:id/financials with kind section. Totals stay server-calculated. Requires write:events.
createEventFinancialEntryeventsAdd a Profit & Loss line item on an event. Pass the event id, sectionId, scenario, type, and label. Same as POST /api/events/:id/financials with kind entry. Totals stay server-calculated. Requires write:events.
reorderEventFinancialSectionseventsReorder Profit & Loss sections on an event. Pass orderedSectionIds. Same as POST /api/events/:id/financials with kind reorder-sections. Requires write:events.
reorderEventFinancialEntrieseventsReorder Profit & Loss line items in a section. Pass sectionId and orderedEntryIds. Same as POST /api/events/:id/financials with kind reorder-entries. Requires write:events.
updateEventFinancialSectioneventsChange a Profit & Loss section name or type. Pass the event id and section id. Same as PUT /api/events/:id/financials/sections/:sectionId. Requires write:events.
deleteEventFinancialSectioneventsRemove a Profit & Loss section and its line items. Pass the event id and section id. Same as DELETE /api/events/:id/financials/sections/:sectionId. Requires write:events.
updateEventFinancialEntryeventsChange a Profit & Loss line item. Pass the event id and entry id. Same as PUT /api/events/:id/financials/entries/:entryId. Totals stay server-calculated. Requires write:events.
deleteEventFinancialEntryeventsRemove a Profit & Loss line item. Pass the event id and entry id. Same as DELETE /api/events/:id/financials/entries/:entryId. Requires write:events.
applyEventFinancialsBatcheventsApply several Profit & Loss changes in one request, matching Event → Profit & Loss Save. Same as POST /api/events/:id/financials/batch. Pass operations. Totals stay server-calculated. Requires write:events.
getEventLineupeventsRead Event → Lineup for a show: slots, changeovers, Published / Hidden, stages, and extra named lineups. Same JSON as GET /api/events/:id/lineups. Editors see Hidden rows and notes; read-only viewers see Published rows only. Pass include=lineup on getEvent for the same bundle on the event. Requires read:events.
createEventLineupeventsAdd an extra named Lineup on a show. The default bill is named Lineup and is created on first editor GET. Requires write:events.
updateEventLineupeventsRename a Lineup or change Published / Hidden for the whole bill. Requires write:events.
deleteEventLineupeventsRemove an extra named Lineup. The last Lineup is replaced with a default empty bill. Requires write:events.
createEventLineupItemeventsAdd a slot, a typed name, or a changeover on a Lineup. kind is appearance (default) or changeover. Add a name or a time. Requires write:events.
updateEventLineupItemeventsChange a Lineup slot: name, clocks, stage, Published / Hidden, notes, or unlink the booking (keeps the hole). Pass itemId. Requires write:events.
deleteEventLineupItemeventsRemove a slot or changeover from the Lineup. Linked bookings write an exclusion so confirm will not recreate that hole. Requires write:events.
addEventLineupItemFromBookingeventsAdd a booking that is already on the event to the Lineup, or fill an empty slot (targetItemId). Optional bookingSlotId and followBookingTimes. Requires write:events.
reorderEventLineupItemseventsSet the Lineup order. Pass itemIds in the new order. Requires write:events.
announceEventLineupItemseventsSet Published or Hidden on Lineup slots. Pass isPublic and itemIds, or replaceBill to hide every other live act. Requires write:events.
createEventStageeventsAdd a stage on this show (name, colour, internal notes). Requires write:events.
updateEventStageeventsRename a stage or change its colour or internal notes. Requires write:events.
deleteEventStageeventsRemove a stage from this show. Requires write:events.
searchTourstoursSearch tours. Requires read:tours on an API key.
getTourtoursRetrieve one tour by UUID. Requires read:tours. Does not return ticket reports or public share tokens/URLs (ticket report, runsheet). Use getTourTicketSalesReport.
createTourtoursCreate a tour. Requires name, startDate, and endDate. Type, status, and labels are optional and fall back to the account defaults. Requires write:tours.
updateTourtoursUpdate a tour, including its type, status, and labels. Requires write:tours.
deleteTourtoursDelete a tour. Requires write:tours. No separate delete scope.
listTourTypestoursList tour types this Account can pick. These are not event labels. Requires read:tours.
createTourTypetoursAdd a custom tour type. Tours add-on required. Requires write:tours.
updateTourTypetoursRename or recolor a tour type. Requires write:tours.
deleteTourTypetoursRemove a tour type from new picks. Requires write:tours.
listTourStatusestoursList tour statuses this Account can pick. Requires read:tours.
createTourStatustoursAdd a custom tour status. Tours add-on required. Requires write:tours.
updateTourStatustoursRename or recolor a tour status. Requires write:tours.
deleteTourStatustoursRemove a tour status from new picks. Requires write:tours.
listTourLabelstoursList tour labels this Account can pick. These are not event labels. Requires read:tours.
createTourLabeltoursAdd a custom tour label. Tours add-on required. Requires write:tours.
updateTourLabeltoursRename or recolor a tour label. Requires write:tours.
deleteTourLabeltoursRemove a tour label from new picks. Requires write:tours.
getEventTicketSalesReportticket-reportsSold, remaining, capacity, and money totals for one show, including per-source and per-type rows. Totals follow the show date, not the purchase date. REST wraps { data }; this tool returns the DTO without that wrapper. Money fields are decimal strings (2dp). Type-row available null means unlimited remaining. Requires read:ticket-reports (read:events is not enough).
getTourTicketSalesReportticket-reportsSold, remaining, capacity, and money totals for a tour and each of its shows. Totals follow each show date, not the purchase date. REST wraps { data }; this tool returns the DTO without that wrapper. Money fields are decimal strings (2dp). Requires read:ticket-reports (read:tours is not enough).
Permission scopes
Each API key is granted one or more scopes:
read:eventsscopeRequired for GET /api/events, GET /api/events/:id, GET /api/event-statuses, GET /api/event-labels, GET /api/event-types, GET /api/event-item-types, GET /api/event-items, GET /api/event-items/:id, GET /api/events/:id/financials, GET /api/events/:id/lineups, and GET /api/events/:id/stages.
write:eventsscopeRequired for POST, PUT and DELETE against /api/events, event catalogs, /api/event-item-types, /api/event-items, including POST /api/event-items/:id/complete, Profit & Loss, and Lineup. Publish and Event list flags on a status need an Account admin. Covers delete. There is no separate delete:events scope.
read:toursscopeRequired for GET /api/tours, GET /api/tours/:id, GET /api/tour-types, GET /api/tour-statuses, and GET /api/tour-labels.
write:toursscopeRequired for POST, PUT and DELETE against /api/tours, /api/tour-types, /api/tour-statuses, and /api/tour-labels. Tours add-on required for catalog writes. Covers delete. There is no separate delete:tours scope.
read:ticket-reportsscopeRequired for GET /api/events/:id/ticket-sales-report and GET /api/tours/:id/ticket-sales-report. read:events / read:tours is not enough.
A key with the wildcard * scope has full access to every endpoint. We recommend issuing narrowly-scoped keys per integration.
On an API key, every MCP tool except whoami uses the same scope as the matching route. Event tools use read:events and write:events, including schedule items, Lineup, and Profit & Loss. Tour tools use read:tours and write:tours. Ticket Reports tools use read:ticket-reports. OAuth connections run with *.
Pagination
List endpoints accept page and limit query parameters. The default page size is 10; the maximum is 100. Successful lists wrap the slice in data and put paging under meta.pagination:
{
"data": [ /* array of events */ ],
"meta": {
"pagination": {
"page": 1,
"limit": 10,
"total": 247,
"pages": 25
}
}
}GET /api/event-items uses the same envelope with page, limit, and total (no pages). Retrieve, create, and update wrap a single record in { "data": … }.
Including related data
By default, event responses contain only the event record itself. Use the include query parameter to embed related resources in the response.
venueincludeBasic venue information (id, name).
venue.fullincludeFull venue details including address, city, state, country.
tourincludeBasic tour information (id, name).
tour.fullincludeFull tour details including type and status.
accountincludeBasic account information (id, name).
account.fullincludeFull account details (id, name, slug, imageUrl).
eventItemsincludeSchedule items on the event (every item type, custom types, tasks, and custom fields).
financialsincludeProfit & Loss for the event (Projected and Actual). Same payload as GET /api/events/:id/financials. List GET drops this include; use event GET or the dedicated URL.
lineupincludeEvent → Lineup for the event (slots, changeovers, stages). Same payload as GET /api/events/:id/lineups. List GET drops this include; use event GET or the dedicated URL.
Combine values with commas, e.g. ?include=venue.full,tour,account. Ticket reports use the dedicated Ticket Reports URLs, not include. include=lineup is Event → Lineup, not Event list Show lineup. Share tokens are omitted on API keys.
Event type and status
Create and update payloads use the JSON fields eventType and status.
Defaults on create
- If you omit
eventType, the event is created as typeshow. - If you omit
status, the event is created with statusprivate(the initial lifecycle state before public on-sale messaging). - A sent start time is kept. Only missing
endDate,timezone, orisAllDayare filled. A calendar day (yyyy-MM-dd) gets default clocks from Edit Event Type, then Settings → Events, then 8:00 pm–10:00 pm, or all-day when the type has blank time.
Setting status values
Use a lowercase string. Allowed status values are:
privateoff_saleannouncedpre_saleon_salesold_outallocation_fullevent_endedcancelled
Set status on create or update when you need a lifecycle state other than the default (for example announced or on_sale).
Setting eventType values
Use a lowercase string. Allowed type values are:
showtravelday_off
Custom event types: create, rename, and remove macro types with POST /api/event-types, PUT /api/event-types/:id, and DELETE /api/event-types/:id (MCP createEventType / updateEventType / deleteEventType). List them with GET /api/event-types. Schedule-item types use /api/event-item-types.
Event custom fields
Shows have custom fields too, not only schedule items. Put internal notes in those fields, not in the public description.
Show Details lives on typeSpecificData. Account defaults come from GET /api/event-types (MCP listEventTypes) as fields. Extra fields on one show use typeSpecificData.custom[key] with definitions in typeSpecificData._ui.customFields. That is the same shape the event panel renders, and those values can appear on runsheets.
Reporting is privateReportingData. Same field engine, stored separately so it stays off offers and runsheets.listEventTypes does not return Reporting field lists. Default keys when none are saved: doorList, notes, attendance, technicalAudio, staff, overall.
Read values with GET /api/events/:id or MCP getEvent. On update, typeSpecificData is shallow-merged; privateReportingData replaces the whole object — get the event first and merge.
{
"eventId": "eb5e650a-a862-4310-8eb9-42222f5150df",
"typeSpecificData": {
"custom": { "private_notes": "Hold the downstairs bar for load-in." },
"_ui": {
"customFields": [
{ "key": "private_notes", "label": "Private notes", "type": "textarea" }
]
}
}
}Errors
All errors use a consistent JSON envelope and the HTTP status code reflects the error class.
{
"error": {
"code": "INVALID_API_KEY",
"message": "Invalid or expired API key"
}
}MISSING_API_KEY401The X-API-Key header was not present.
INVALID_API_KEY401The supplied key was unknown, expired, or revoked.
FORBIDDEN403The key is valid but does not have the scope required for this endpoint.
VALIDATION_ERROR400Request body or query parameters failed schema validation.
NOT_FOUND404The requested resource does not exist in your account.
RATE_LIMIT_EXCEEDED429You have sent too many requests in a short period. Respect the X-RateLimit-Reset header.
Rate limits
Every API key is rate limited on a rolling hourly window:
- 1,000 requests per hour across read endpoints (
GET) - 200 requests per hour across write endpoints (
POST,PUT,DELETE)
These are our current limits. If you have a use case that needs more headroom, get in touch.
Every response includes the following headers so your client can pace itself:
X-RateLimit-LimitintegerThe maximum number of requests allowed in the current window.
X-RateLimit-RemainingintegerThe number of requests remaining in the current window.
X-RateLimit-Resetunix timestampThe time at which the current window resets.
Events API
Events are the core unit of the Muzeek data model — a scheduled occurrence (show, travel day, day off, etc.) that optionally lives on a tour and at a venue. The Events API lets you list, retrieve, create, update and delete events.
If your account manages other accounts via a roster (for example, an agent or manager with an artist roster), you can also create events for a roster member by passing their account UUID as forAccountId on create. See Create an event.
Query parameters
pageintegerPage number. Defaults to 1.
limitintegerItems per page. Defaults to 10, max 100.
sortBystringOne of startDate, title, createdAt. Defaults to startDate.
sortOrderstringasc or desc. Defaults to desc.
searchstringFree-text search across event title.
typesstring[]Filter by event type (repeatable). Example: ?types=show&types=travel.
tourIduuidLimit the list to shows on this tour.
statusesstring[]Filter by status (repeatable). Example: ?statuses=private&statuses=announced.
startDateISO 8601Only return events whose startDate is on or after this value.
endDateISO 8601Only return events whose startDate is on or before this value.
includestringComma-separated list. See the Includes section above.
Example
curl "https://muzeek.ai/api/events?limit=5&include=venue,tour" \
-H "X-API-Key: $MUZEEK_API_KEY"Path parameters
iduuidThe event UUID.
Query parameters
includestringComma-separated list. See Includes.
Example request
curl "https://muzeek.ai/api/events/123e4567-e89b-12d3-a456-426614174000?include=venue,tour" \
-H "X-API-Key: $MUZEEK_API_KEY"Example response
{
"data": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"title": "Summer Showcase",
"description": null,
"eventType": "show",
"startDate": "2026-08-15T20:00:00.000Z",
"endDate": "2026-08-15T23:00:00.000Z",
"timezone": "Europe/London",
"isAllDay": false,
"isPublished": true,
"status": "announced",
"capacity": 500,
"imageUrl": null,
"venueId": "6a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
"tourId": null,
"createdAt": "2026-04-01T10:15:30.000Z",
"updatedAt": "2026-04-02T09:00:00.000Z",
"venue": {
"id": "6a1b2c3d-4e5f-6071-8293-a4b5c6d7e8f9",
"name": "The Lexington"
},
"tour": null,
"typeSpecificData": {
"notes": "Doors 8pm, 18+",
"custom": { "private_notes": "Hold the downstairs bar for load-in." },
"_ui": {
"customFields": [
{ "key": "private_notes", "label": "Private notes", "type": "textarea" }
]
}
},
"privateReportingData": {
"notes": "Internal wrap notes for the Account only."
}
}
}Retrieve, create, and update wrap the event in data. Fields omitted above that you may also see: description, capacity, imageUrl, status, currencyCode, and location fields (locationName, locationAddress, …). Fields that are unset come back as null; optional objects like venue and tour are only present when requested via include. Ticket reports use the dedicated Ticket Reports URLs, not include. Pass include=financials for Profit & Loss. Pass include=lineup for Event → Lineup. GET does not return venueContactId. Public share tokens and URLs (ticket report, runsheet, Profit & Loss) are omitted on the event and nested tour.
Path parameters
iduuidThe event UUID.
Query parameters
scenariostringactual, projected, or both. Defaults to both. A single scenario omits the other key.
Example response
{
"data": {
"projected": {
"sections": [
{
"id": "aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee",
"scenario": "projected",
"name": "Bar",
"type": "revenue",
"sortOrder": 0,
"createdAt": "2026-04-01T10:15:30.000Z",
"updatedAt": "2026-04-01T10:15:30.000Z"
}
],
"entries": [
{
"id": "11111111-2222-4333-8444-555555555555",
"sectionId": "aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee",
"scenario": "projected",
"type": "revenue",
"label": "Bar Revenue",
"amount": 1500,
"calcType": "fixed",
"taxMode": "exclusive",
"sortOrder": 0,
"createdAt": "2026-04-01T10:15:30.000Z",
"updatedAt": "2026-04-01T10:15:30.000Z"
}
],
"totals": {
"revenueSubtotal": 1500,
"costsSubtotal": 0,
"revenueTotal": 1500,
"costsTotal": 0,
"net": 1500,
"total": 1500,
"marginPercent": 100
}
},
"actual": {
"sections": [],
"entries": [],
"totals": {
"revenueSubtotal": 0,
"costsSubtotal": 0,
"revenueTotal": 0,
"costsTotal": 0,
"net": 0,
"total": 0,
"marginPercent": 0
}
}
}
}REST and MCP getEventFinancials both wrap the bundle in data. Amounts and totals are numbers, not decimal strings. type is revenue or cost. Line-item calcType is fixed or percent_of. taxMode is inclusive, exclusive, or none. Totals stay server-calculated — do not send net, margin, or tax totals on writes. The public P&L Report token URL is not how scripts authenticate.
Request body
kindstringsection, entry, reorder-sections, or reorder-entries. MCP splits these kinds into object tools.
scenariostringactual or projected. Required for section, entry, and reorder-sections.
namestringSection name when kind is section.
typestringrevenue or cost. Required for section and entry.
sectionIduuidParent section when kind is entry or reorder-entries.
labelstringLine-item label when kind is entry.
Example request
curl -X POST https://muzeek.ai/api/events/123e4567-e89b-12d3-a456-426614174000/financials \
-H "X-API-Key: $MUZEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"kind": "section",
"scenario": "projected",
"name": "Bar",
"type": "revenue"
}'Create returns 201 with { "data": <section or entry> }. Reorder returns { "data": { "success": true } }.
Request body
operationsarrayCreate, update, delete, and reorder operations in order. Create ops use tmpId; the response idMap maps each tmpId to the new UUID.
Example response
{
"data": {
"success": true,
"idMap": { "tmp_bar": "aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee" },
"createdSections": [
{
"tmpId": "tmp_bar",
"id": "aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee",
"scenario": "projected",
"name": "Bar",
"type": "revenue",
"sortOrder": 0
}
],
"createdEntries": []
}
}Path parameters
iduuidThe event UUID.
Path parameters
iduuidThe event UUID.
Example response
{
"data": {
"eventId": "123e4567-e89b-12d3-a456-426614174000",
"title": "Summer Showcase",
"startDate": "2026-08-15T20:00:00.000Z",
"timezone": "Europe/London",
"currencyCode": "GBP",
"capacity": 500,
"ticketsSold": 120,
"ticketsAvailable": 380,
"percentSold": 24,
"faceRevenue": "1800.00",
"consumerRevenue": "1980.00",
"ticketNet": "1620.00",
"settlementAmount": "1620.00",
"usesSettlementTotals": false,
"settlementStatus": null,
"settlementSource": "calculated",
"sources": [
{
"name": "Door",
"kind": "door",
"sold": 120,
"available": 380,
"faceRevenue": "1800.00",
"consumerRevenue": "1980.00",
"ticketNet": "1620.00",
"settlementAmount": "1620.00",
"types": [
{
"name": "GA",
"groupName": "General",
"sold": 120,
"available": 380,
"priceFace": "15.00",
"consumerPrice": "16.50",
"faceRevenue": "1800.00",
"consumerRevenue": "1980.00",
"ticketNet": "1620.00",
"settlementAmount": "1620.00"
}
]
}
]
}
}REST wraps the DTO in data. MCP getEventTicketSalesReport returns the same object without that wrapper. Money fields are decimal strings (2dp). Type-row available: null means unlimited remaining. kind is custom, door, or integration. settlementSource is provider, calculated, or null. Session GET /ticket-report stays session-only. Rate limit is the GET api window (1,000 / hour).
Request body
titlestringOptional. At most 255 characters. Empty or omitted becomes No Event Title.
startDateISO 8601 or yyyy-MM-ddEvent start. ISO datetime or a calendar day. A sent time is kept. A calendar day gets default clocks, or all-day when the type has blank time.
endDateISO 8601Optional. A sent start time is kept; only a missing end is filled from type then Settings then 10:00 pm. A calendar day with no times uses type then Settings then 8:00 pm–10:00 pm.
timezoneIANA timezoneOptional. E.g. "Europe/London". Omitted uses auto-seed, then the Account timezone.
isAllDaybooleanOptional. Omitted follows the type, then Settings. Blank type time becomes all-day.
eventTypestringEvent type. Defaults to show. See Event type and status.
venueIduuidVenue UUID. Mutually exclusive with venueContactId.
venueContactIduuidContact UUID from the app (no public contacts list). Mutually exclusive with venueId. Write-only: GET event does not return this field.
locationNamestringPlace name and the other location columns (locationAddress, locationCity, …). Same keys as GET event location fields.
tourIduuidTour UUID.
capacityintegerPositive integer capacity.
imageUrlhttps urlREST only. MCP createEvent and updateEvent omit this field. Pass null or empty string to clear.
isPublishedbooleanWhether the event is publicly visible.
statusstringEvent lifecycle status. Defaults to private. See Event type and status.
labelKeysstring[]Labels on the show. Sending the list replaces the set. An empty list clears them.
forAccountIduuidOptional. Beneficiary roster account — create the event for a member of your roster. The caller must be an active roster owner of this account, otherwise the request returns 403 FORBIDDEN. Omit or pass your own account UUID to create on your own account.
descriptionstringPublic-facing show copy. Do not put internal or private notes here.
typeSpecificDataobjectShow Details. Account defaults from GET /api/event-types fields. Extra per-show fields: custom[key] plus _ui.customFields.
privateReportingDataobjectReporting. Internal notes that stay off runsheets and offers. Not listed by listEventTypes.
Example
curl -X POST https://muzeek.ai/api/events \
-H "X-API-Key: $MUZEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Summer Showcase",
"eventType": "show",
"startDate": "2026-08-15T20:00:00Z",
"endDate": "2026-08-15T23:00:00Z",
"timezone": "Europe/London",
"isAllDay": false,
"venueId": "123e4567-e89b-12d3-a456-426614174000"
}'Creating for a roster member
If your account manages other accounts via a roster (e.g. an agent or manager with an artist roster), pass the member's account UUID as forAccountId. The event is created on the member's account and attributed to you as the creator. The scope required is still write:events; the roster relationship itself is the authorisation boundary.
curl -X POST https://muzeek.ai/api/events \
-H "X-API-Key: $MUZEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Roster Member Show",
"eventType": "show",
"startDate": "2026-08-15T20:00:00Z",
"endDate": "2026-08-15T23:00:00Z",
"timezone": "Europe/London",
"isAllDay": false,
"forAccountId": "9f8e7d6c-5b4a-3210-fedc-ba9876543210"
}'Note: the member's account UUID is not currently listable via the API — retrieve it from the Muzeek app and pass it through your integration as configuration.
Request body
isPublishedbooleanWhether the show is published. Omit to leave it unchanged.
statusstringEvent lifecycle status. Omit to leave it unchanged.
labelKeysstring[]Labels on the show. Sending the list replaces the set. An empty list clears them. Omit to leave the labels unchanged.
venueContactIduuidContact UUID from the app. Mutually exclusive with venueId. Write-only: GET event does not return this field.
imageUrlhttps urlREST only. MCP updateEvent omits this field.
descriptionstringPublic-facing show copy. Null clears. Do not put internal notes here.
typeSpecificDataobjectShow Details. Shallow-merged with the stored object. Merge custom and _ui.customFields from GET first.
privateReportingDataobjectReporting. Replaces the stored blob. GET first and merge.
Example
curl -X PUT https://muzeek.ai/api/events/123e4567-e89b-12d3-a456-426614174000 \
-H "X-API-Key: $MUZEEK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Summer Showcase (rescheduled)",
"startDate": "2026-08-16T20:00:00Z",
"endDate": "2026-08-16T23:00:00Z"
}'Example
curl -X DELETE https://muzeek.ai/api/events/123e4567-e89b-12d3-a456-426614174000 \
-H "X-API-Key: $MUZEEK_API_KEY"Example response
{
"message": "Event deleted successfully"
}DELETE is covered by the write:events scope. There is no separate delete:events scope.
Event catalogs API
Status, labels, and macro types are lists on this Account. Create a row, then apply its key on a show. Status and published are separate: omit status on create and the show starts private and unpublished, then existing reconciliation still runs. Settings /api/account-* URLs stay session-only.
Event items API
Event items are rows on an event — soundcheck, load-in, flights, lobby call, todos, and any types this Account still has. They are not extra events. Call GET /api/event-item-types (MCP listEventItemTypes) for the typeKey values and field definitions this Account currently has. Accounts can rename or delete types; do not assume a key exists.
Query parameters
eventIduuidParent event UUID.
itemTypestringtypeKey from GET /api/event-item-types for this Account.
pageintegerPage number. Defaults to 1.
limitintegerItems per page. Defaults to 50, max 500.
Request body
eventIduuidParent event UUID.
itemTypestringtypeKey from GET /api/event-item-types for this Account. Accounts can rename or delete system-provided types.
startDateISO 8601Optional clock start. Null for unscheduled.
endDateISO 8601Optional clock end.
timingModestringclock or relative.
isTaskbooleanTrue for a checklist or todo row.
typeSpecificDataobjectValues for the type's field keys from GET /api/event-item-types. Dot paths nest objects. Clock times stay on startDate and endDate. Extra per-item fields: custom[key] plus _ui.customFields.
isCompletedbooleanTrue to complete, false to reopen.
Tours API
Shows belong to a tour through the event's tourId, not through a separate membership call. Tour type, status, and label lists are public catalogs: list them, then apply keys on createTour and updateTour. Writes need the Tours add-on. Settings /api/account-tour-* stays session-only.
Tour catalogs
Query parameters follow the events list: page, limit, sortBy, sortOrder, search, type, category, status, and include.
Path parameters
iduuidThe tour UUID.
REST wraps { "data": <tour report> }. MCP getTourTicketSalesReport returns the DTO without that wrapper. read:tours is not enough.
Required fields
namestringTour name.
startDatedatetimeISO datetime.
endDatedatetimeISO datetime. Must be after startDate.
typestringTour type key from the account catalog. Omit to use the default for new tours.
statusstringTour status key from the account catalog. Omit to use the default for new tours.
labelKeysstring[]Tour label keys. Omit to use the defaults for new tours. Sending the list replaces the set.
categorystringdomestic or international.
Maintain type, status, and label lists with the tour catalog routes (or MCP listTourTypes / createTourType and the matching status and label tools), then apply keys here.
DELETE is covered by write:tours. There is no separate delete:tours scope.