DoorSplit API

Returns all published events. Filter by organization or date range.

Query parameters:

curl "https://api.doorsplit.app/discover/events?org_id=abc-123&date_from=2026-06-01T00:00:00Z"

Look up an organization by its URL-friendly slug (e.g. the-midnight-club).

List all published events for an organization by slug. Useful for building a venue or band's upcoming shows page.

Get full details for a single event — name, venue, date/time, tiered pricing, poster URL. Authenticated callers with event access also receive private fields like capacity and tickets sold.

Preview the fee breakdown before creating a checkout session. Shows face value, service fee, and buyer total. Use this to display transparent pricing to buyers.

curl -X POST https://api.doorsplit.app/checkout/fee-estimate \
  -H "Content-Type: application/json" \
  -d '{"event_id": "EVENT_ID", "quantity": 2}'

// Response:
{
  "face_value_cents": 2000,
  "service_fee_cents": 235,
  "buyer_total_cents": 2235,
  "platform_fee_cents": 140,
  "stripe_fee_cents": 95
}

Create a Stripe Checkout Session. Returns a checkout_url — redirect the buyer there to complete payment. Guest checkout requires customer_email; authenticated users are linked automatically.

curl -X POST https://api.doorsplit.app/checkout/sessions \
  -H "Content-Type: application/json" \
  -d '{
    "event_id": "EVENT_ID",
    "quantity": 2,
    "customer_email": "buyer@example.com",
    "success_url": "https://yoursite.com/success?session_id={CHECKOUT_SESSION_ID}",
    "cancel_url": "https://yoursite.com/events/EVENT_ID"
  }'

Check payment status after Stripe redirects back. Returns payment_status and ticket IDs when paid.

List the authenticated user's tickets. Returns ticket ID, event, status (valid/used/cancelled), QR code info, and purchase details.

Get a single ticket with its pre-signed QR code URL. Users can view their own tickets.

Lightweight public check — returns whether a ticket is valid without marking it as used. Useful for external validation systems.

Cancel a ticket. Users can cancel their own tickets.

Mark a single ticket as used. Returns 409 if already scanned, 410 if cancelled. Requires event collaborator or org admin access.

Get a ticket group summary — total tickets, how many are valid/used/cancelled. When someone bought multiple tickets, they share a single QR code (group). The door person scans it and sees how many to admit.

Admit N people from a group. For example: 3 tickets purchased, only 2 people present — admit 2 and the QR stays valid for 1 remaining ticket.

curl -X POST https://api.doorsplit.app/ticket-groups/GROUP_ID/scan \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"count": 2}'

// Response:
{
  "admitted": 2,
  "remaining": 1,
  "total": 3,
  "message": "Admitted 2, 1 remaining"
}

Create a payment session for walk-up purchases. Returns a QR code (checkout mode) or a PaymentIntent client_secret (tap-to-pay mode) for the buyer to pay at the door.

Create a new event with name, venue, date, pricing tiers, and capacity. Requires org admin of the event's organization.

Update event details, pricing, or status. Setting status to completed triggers automatic revenue payouts to all collaborator organizations via Stripe.

Add a user or organization as an event collaborator. Set their role (admin/manager) and revenue share percentage.

Issue a free guest ticket by email. If the email belongs to an existing user, the ticket is linked to their account.

Create an organization. The creator becomes org admin automatically.

List organizations the authenticated user belongs to.

Start Stripe Connect onboarding. Returns an onboarding URL to redirect the org admin to Stripe's hosted setup page.

Request an instant payout for an event's ticket revenue. A 3% convenience fee is deducted. Standard payouts (on event completion) are free.