Greenroom API v1

Build on the booking desk.

Connect profiles, availability, show advancing, promoter events, invoices, booking calls, introductions, public scene discovery, and Greenroom match intelligence.

Base URL/api/v1

AuthenticationBearer / OAuth

Account limit300 / min

Authentication

One credential, one account.

API keys inherit the owning account role. Create one at the developer portal, store it as a server-side secret, and send it in the Authorization header. OAuth access tokens are limited to the approved DJ calendar surface. Revocation takes effect on the next request.

curl "https://greenroom.dance/api/v1/calendar?kind=gig&limit=20" \
  -H "Authorization: Bearer $GREENROOM_API_KEY"

Pagination

Follow the cursor.

Collections default to 25 records and accept up to 100. Pass the returned nextCursor back as cursor. Treat cursors as opaque values.

{"meta":{"count":20,"hasMore":true,"nextCursor":"eyJvZmZzZXQiOjIwfQ"}}

Errors

Stable codes, readable context.

Failures return an error object with a machine code and message. Use HTTP status for the broad class and the code for integration logic. A 429 response includes Retry-After.

{"error":{"code":"invalid_request","message":"endsOn must be on or after startsOn."}}

Incremental sync

Move only what changed.

Calendar and invoice lists accept updated_after. Introductions accept created_after. Dates use YYYY-MM-DD and timestamps use ISO 8601.

Connected apps

Consent and change delivery.

DJ accounts can register OAuth clients and signed webhook endpoints in the developer portal. Client secrets and webhook secrets are shown once.

OAuth Authorization Code

Send the DJ to the authorization URL with the exact registered HTTPS redirect URI and an opaque state value. Exchange the one-time code within ten minutes. The returned Bearer token carries the calendar scope and works on /me and calendar operations.

https://greenroom.dance/oauth/authorize?response_type=code&client_id=CLIENT_ID&redirect_uri=https%3A%2F%2Fapp.example%2Fgreenroom%2Fcallback&state=OPAQUE_STATE

curl https://greenroom.dance/api/oauth/token \
  -u "CLIENT_ID:CLIENT_SECRET" \
  -d grant_type=authorization_code \
  -d code=ONE_TIME_CODE \
  -d redirect_uri=https://app.example/greenroom/callback

Signed webhooks

Subscribe a reachable public HTTPS endpoint to calendar.created, calendar.updated, and calendar.deleted. Greenroom signs the exact JSON body with HMAC-SHA256.

Greenroom-Signature: sha256=HEX_HMAC
User-Agent: Greenroom-Webhooks/1.0

Compute HMAC-SHA256 with the webhook secret, compare the hexadecimal digest in constant time, and reject mismatches before processing the event. The payload includes id, event, createdAt, and data.

MCP server

Install the agent surface.

Tell Claude Code, “Install the Greenroom MCP.” Give it the installer record at /api/mcp/install, or run the command directly after setting GREENROOM_API_KEY.

claude mcp add --transport http --scope user \
  greenroom https://greenroom.dance/api/mcp \
  --header 'Authorization: Bearer ${GREENROOM_API_KEY}'

Transport: stateless Streamable HTTP. Endpoint: https://greenroom.dance/api/mcp. Contract resource: greenroom://api/openapi.

Profile

get_account
Identify the account attached to the key.
get_profile
Read the owned DJ or promoter profile.
update_dj_profile
Merge public, booking, and travel fields.
update_promoter_profile
Merge claimed promoter profile fields.

Show operations

list_calendar
Search DJ calendar entries.
create_calendar_entry
Create a city, blocked date, or gig.
update_show_desk
Replace deal, advancing, travel, and tasks.
inspect_show_readiness
Audit advancing gaps and unfinished tasks.

Promoter and finance

list_promoter_events
Search events owned by the promoter.
create_promoter_event
Create a draft or published event.
list_invoices
Search account-owned invoices.
create_invoice_draft
Create an unsent invoice draft.

Network intelligence

list_booking_opportunities
Find visible booking calls.
publish_booking_opportunity
Publish a follower or network call.
list_introductions
Check introduction movement.
respond_to_introduction
View, reply, accept, or decline.
search_venues
Search the sourced public venue directory.
search_djs
Search public DJ profiles.
search_network
Search privacy-safe counterpart profiles.
recommend_promoters
Rank promoter fit with explanations.

REST reference

Every operation in v1.

This reference is rendered from the same OpenAPI contract returned by the API. Request ownership, role checks, and contact privacy are enforced server-side.

Identity

Bearer credential identity and API-key-owned profile.

get/api/v1/meGet the Bearer credential ownerBearer / OAuth

Operation IDgetCurrentAccount

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

get/api/v1/profileGet the DJ or promoter profile owned by the API keyAny key

Operation IDgetAccountProfile

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

patch/api/v1/profileMerge editable fields into the account profileAny key

Operation IDupdateAccountProfile

Request bodyRole-specific profile patch

Responses200, 400, 401, 403, 404, 409, 429, 500

Operations

Calendar, show desk, and promoter event workflows.

get/api/v1/calendarList travel, gig, and blocked calendar entriesDJ key / OAuth

Operation IDlistCalendarEntries

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

limitqueryinteger. Default: 25

cursorqueryOpaque cursor returned by the previous page.

kindqueryComma-separated city, gig, or blocked values.

fromqueryInclude entries ending on or after this YYYY-MM-DD date.

toqueryInclude entries starting on or before this YYYY-MM-DD date.

updated_afterqueryInclude entries changed after this ISO 8601 timestamp.

qquerySearch title, city, venue, and notes.

post/api/v1/calendarCreate a calendar entry or confirmed show deskDJ key / OAuth

Operation IDcreateCalendarEntry

Request bodyCalendarEntryInput

Responses201, 400, 401, 403, 404, 409, 429, 500

patch/api/v1/calendarReplace a show desk using the legacy collection routeDJ key / OAuth

Operation IDreplaceLegacyShowDesk

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Deprecated compatibility route. New integrations should use the resource detail path.

delete/api/v1/calendarDelete a calendar entry using the legacy collection routeDJ key / OAuth

Operation IDdeleteLegacyCalendarEntry

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Deprecated compatibility route. New integrations should use the resource detail path.

Parameters

idqueryCalendar entry ID.

get/api/v1/calendar/{id}Get one calendar entry and its show deskDJ key / OAuth

Operation IDgetCalendarEntry

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

patch/api/v1/calendar/{id}Update calendar, deal, contract, advancing, travel, tasks, or settlementDJ key / OAuth

Operation IDupdateCalendarEntry

Request bodyCalendarEntryPatch

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

delete/api/v1/calendar/{id}Delete a calendar entryDJ key / OAuth

Operation IDdeleteCalendarEntry

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

get/api/v1/eventsList events owned by a promoter accountPromoter key

Operation IDlistPromoterEvents

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

limitqueryinteger. Default: 25

cursorqueryOpaque cursor returned by the previous page.

statusqueryComma-separated draft or published values.

fromqueryInclude events on or after this YYYY-MM-DD date.

toqueryInclude events on or before this YYYY-MM-DD date.

qquerySearch title, city, and venue.

post/api/v1/eventsCreate a promoter eventPromoter key

Operation IDcreatePromoterEvent

Request bodyEventInput

Responses201, 400, 401, 403, 404, 409, 429, 500

get/api/v1/events/{id}Get one promoter eventPromoter key

Operation IDgetPromoterEvent

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

patch/api/v1/events/{id}Update a promoter eventPromoter key

Operation IDupdatePromoterEvent

Request bodyEventPatch

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

delete/api/v1/events/{id}Delete a promoter eventPromoter key

Operation IDdeletePromoterEvent

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

Finance

Account-owned invoice workflows.

get/api/v1/invoicesList account invoicesAny key

Operation IDlistInvoices

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

limitqueryinteger. Default: 25

cursorqueryOpaque cursor returned by the previous page.

statusqueryComma-separated draft, sent, paid, overdue, or void values.

due_fromqueryInclude invoices due on or after this YYYY-MM-DD date.

due_toqueryInclude invoices due on or before this YYYY-MM-DD date.

updated_afterqueryInclude invoices changed after this ISO 8601 timestamp.

qquerySearch number, recipient, event, venue, and city.

post/api/v1/invoicesCreate and optionally send an invoiceAny key

Operation IDcreateInvoice

Request bodyInvoiceInput

Responses201, 400, 401, 403, 404, 409, 429, 500

get/api/v1/invoices/{id}Get one invoiceAny key

Operation IDgetInvoice

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

patch/api/v1/invoices/{id}Send or void an invoiceAny key

Operation IDactOnInvoice

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

Network

Booking opportunities, introductions, and visible counterparts.

get/api/v1/opportunitiesList visible booking opportunitiesAny key

Operation IDlistBookingOpportunities

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

limitqueryinteger. Default: 25

cursorqueryOpaque cursor returned by the previous page.

statusqueryComma-separated open or closed values.

cityqueryMatch an exact city.

fromqueryInclude opportunities on or after this YYYY-MM-DD date.

toqueryInclude opportunities on or before this YYYY-MM-DD date.

qquerySearch title, description, city, and venue.

post/api/v1/opportunitiesPublish a booking opportunityPromoter key

Operation IDcreateBookingOpportunity

Request bodyOpportunityInput

Responses201, 400, 401, 403, 404, 409, 429, 500

get/api/v1/opportunities/{id}Get a visible booking opportunityAny key

Operation IDgetBookingOpportunity

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

patch/api/v1/opportunities/{id}Open or close an owned booking opportunityPromoter key

Operation IDupdateBookingOpportunity

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

get/api/v1/introsList account introduction movementAny key

Operation IDlistIntroductions

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

limitqueryinteger. Default: 25

cursorqueryOpaque cursor returned by the previous page.

statusqueryComma-separated sent, viewed, replied, accepted, or declined values.

created_afterqueryInclude introductions created after this ISO 8601 timestamp.

get/api/v1/intros/{id}Get one introductionAny key

Operation IDgetIntroduction

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

patch/api/v1/intros/{id}Record a promoter response to an introductionPromoter key

Operation IDupdateIntroduction

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

idpath · requiredOpaque Greenroom resource ID.

get/api/v1/locationsList supported booking marketsAny key

Operation IDlistLocations

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

limitqueryinteger. Default: 25

cursorqueryOpaque cursor returned by the previous page.

country_codequeryMatch a two-letter country code.

regionqueryMatch a Greenroom region.

qquerySearch location name, slug, and aliases.

get/api/v1/networkFind visible accounts on the other side of the boothAny key

Operation IDlistNetworkCounterparts

Request bodyNone

Responses200, 400, 401, 403, 404, 409, 429, 500

Parameters

limitqueryinteger. Default: 25

cursorqueryOpaque cursor returned by the previous page.

cityqueryMatch an exact city.

genrequeryMatch an exact genre.

qquerySearch public profile fields.