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, door, or collaborator for revenue share with no access) 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 a campaign by setting event_type. Only name and org_id are required beyond that — donation_config falls back to sensible defaults.

curl -X POST https://api.doorsplit.app/events \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "org_id": "ORG_ID",
    "name": "Rebuild the Rehearsal Room",
    "event_type": "donation",
    "donation_config": {
      "suggested_amounts": ["10.00", "25.00", "100.00"],
      "min_amount": "5.00",
      "allow_custom_amount": true,
      "goal_amount": "8000.00",
      "thank_you_message": "You keep the doors open. Thank you.",
      "allow_donor_message": true,
      "absorb_fees": false
    },
    "payout_mode": "scheduled",
    "payout_schedule": "monthly"
  }'

Same endpoint as tickets, but send donation_amount (a dollar string) or donation_amount_cents instead of quantity. Works on /checkout/fee-estimate too. No ticket is created — the donor receives a thank-you email.

curl -X POST https://api.doorsplit.app/checkout/sessions \
  -H "Content-Type: application/json" \
  -d '{
    "event_id": "CAMPAIGN_ID",
    "donation_amount": "25.00",
    "customer_email": "donor@example.com",
    "donor_name": "Jane Doe",
    "donor_message": "Keep it up!",
    "anonymous": false,
    "success_url": "https://yoursite.com/thanks?session_id={CHECKOUT_SESSION_ID}",
    "cancel_url": "https://yoursite.com/campaign"
  }'

Resolves a scanned QR code to the public event. Campaigns use the same static QR codes as doors, so branch on event_type before you render — a campaign has no price, and pricing a quantity against a missing price is how scanners end up charging NaN. Read donation_config, prompt for an amount, and post donation_amount_cents.

qr_token has no effect on the donation path: fee absorption comes from donation_config.absorb_fees, not absorb_door_fees. You may also omit customer_email and let Stripe Checkout collect it — the receipt still sends.

List donations with a summary of what has been paid out and what is still awaiting release. Donations marked anonymous withhold the donor's name and email.

Release everything received since the last cycle. Returns released: false with reason: "nothing_to_release"when there's nothing new, so it is safe to retry.

// Response after a successful cycle:
{
  "event_id": "CAMPAIGN_ID",
  "released": true,
  "payout_cycle_id": "pc_...",
  "donation_count": 34,
  "distributable_cents": 82150,
  "transfer_count": 3
}

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.

Mint a dsk_org_… key. Returns the one-time api_key. Optional label.

curl -X POST https://api.doorsplit.app/organizations/ORG_ID/api-keys \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"label": "Ticketing integration"}'

// Response (api_key shown once):
{ "key_id": "uuid", "api_key": "dsk_org_…", "api_key_shown_once": true, … }

List keys (prefix only, no plaintext).

Update label or set status: revoked (invalidates immediately).

Rotate the plaintext (old key stops working). New api_key shown once.

Add a wholesale partner: quantity tickets on a tier (tier1, tier2, full) at a wholesale_price(what you keep per ticket). Auto-creates the partner's storefront link (storefront_slug). Rejects with 409 when public capacity is insufficient.

curl -X POST https://api.doorsplit.app/events/EVENT_ID/resellers \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "reseller_org_id": "uuid",
    "tier": "full",
    "quantity": 30,
    "wholesale_price": "40.00",
    "auto_release_hours_before": 72
  }'

List all allocations on an event.

Adjust quantity (never below sold), auto_release_at, or notes.

Release unsold seats back to public (idempotent). Also happens automatically at the cutoff.

Remove a partner. Returns 409once they've sold tickets (release instead).

All allocations held by the calling org.

The partner's storefront link(s). Set the selling price by updating custom_price_cents (clamped to ≥ the wholesale price) with a PUT.

curl -X PUT https://api.doorsplit.app/partner/tracked-links/LINK_ID \
  -H "X-Api-Key: dsk_org_…" \
  -H "Content-Type: application/json" \
  -d '{ "custom_price_cents": 6000 }'

Organizer-managed. Create a code scoped to one event; discount_type is percent, fixed (cents), or hidden_tier. Optionally set credit_collaborator_id to credit a commission collaborator on redemption.

List every code on an event (owner-org view).

Preview a code's discount without redeeming. Buyers apply codes at checkout; the checkout flow redeems them atomically.

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

// Response:
{ "code": "TOURING10", "discount_type": "percent", "discount_percent": 10 }

Atomically reserve quantity redemptions — for B2B integrations that hold a redemption before checkout.

Create a short public URL (https://doorsplit.app/l/{slug}) with per-visitor pricing overrides and/or a hidden-tier unlock. Provide custom_price OR discount_percent (mutually exclusive), or neither. Every link carries an auto-minted ref_code for attribution.

List every link on an event (owner-org view).

Resolve a slug to the event's public data plus the link's pricing / hidden tier and a checkout_hint.ref. The frontend forwards that ref into POST /checkout/sessions so revenue attribution reuses the collaborator flow.