Enterprise

API Documentation

Programmatic access to assessments, scores, and reports. Create assessments, fetch BuilderIQ results, and subscribe to events from your own systems.

Getting started

Authenticate, then build.

All requests use a bearer token generated in your organization settings. Base URL: https://api.buildersalpha.com/v1

# Create an assessment for a candidate
curl https://api.buildersalpha.com/v1/assessments \
  -H "Authorization: Bearer $BA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "candidate_email": "jane@company.com",
    "role": "senior-ai-engineer",
    "challenge": "default"
  }'
POST /v1/assessments

Create assessment

Invite a candidate and start a scored session.

GET /v1/assessments/:id

Get result

Fetch BuilderIQ, dimension scores, and report status.

GET /v1/reports/:id

Fetch report

Retrieve the full intelligence report and replay link.

POST /v1/webhooks

Subscribe to events

Get notified when an assessment is completed or scored.

Get API access.

Request a demo and we'll provision API keys and walk your team through the integration.