BuilderBase External API

Programmatic access to your organization, events, registrations, participants, teams, judging, submissions, and check-in scanning. Use it to power kiosks, CRM syncs, dashboards, Discord bots, onboarding pipelines - anything that needs read or write access to your hackathon data without going through the browser UI.

Your first request

curl https://api.builderbase.com/organizations/your-org-slug \
  -H "X-Api-Key: sk_live_..."

You will receive your sk_live_... key from the BuilderBase team. The raw key is provided via a secure one-time link - store it immediately in your own secret manager. BuilderBase only keeps a hash, so a lost key cannot be recovered, only reissued.

Base URL

All endpoints are relative to:

BASE URL https://api.builderbase.com

What you get back

Responses are wrapped in a standard envelope. A read of your organization looks like this:

{
  "success": true,
  "data": {
    "organization": {
      "id": "8f2a9c14-3b7e-4d61-a0f5-6c1b9e2d4a83",
      "name": "Northwind Labs",
      "slug": "northwind-labs"
    }
  }
}

Note that data is not a bare object of fields - the resource is nested under a typed key (here, organization). See Response Format before you write a client.