GelatinGelatin
 Back
Developer API

Gelatin REST API

Build on top of Gelatin. Manage gigs, bookings, and payouts programmatically.

Base URL

v1

Authentication

POST/v1/auth/session

Create a session token

{ "userId": "dj-1" }
DELETE/v1/auth/session
Auth

Sign out current session

GET/v1/auth/me
Auth

Get current user

Gigs

GET/v1/gigs

List all open gigs (paginated)

GET/v1/gigs/{id}

Get a gig by id

POST/v1/gigs
Auth

Create a gig (venue only)

{
  "title": "Saturday Main Room",
  "date": "2026-06-12T22:00:00Z",
  "durationHours": 4,
  "budget": 900,
  "genres": ["Techno", "House"]
}
PATCH/v1/gigs/{id}
Auth

Update a gig

DELETE/v1/gigs/{id}
Auth

Cancel a gig

Bookings

GET/v1/bookings
Auth

List bookings for current user

POST/v1/bookings
Auth

Create a booking proposal

{ "gigId": "gig-1", "djId": "dj-1", "amount": 900 }
PATCH/v1/bookings/{id}
Auth

Update booking status

{ "status": "confirmed" }

DJs

GET/v1/djs

Search DJs by genre, city, rate

GET/v1/djs/{id}

Get a DJ profile

Venues

GET/v1/venues

List venues

GET/v1/venues/{id}

Get a venue profile