Skip to main content

​
Setup your API Key

Before you can make API requests, you’ll need to generate an API key from your AlfaOne dashboard.
1

Navigate to Integrations

Log in to your AlfaOne admin dashboard and navigate to Settings → Integrations.
2

Create an API Key

Click on Generate API Key, provide a descriptive name for your key, and save it.
Store your API key securely. You won’t be able to see the full key again after creation.
3

Copy your API Key

Copy the generated API key. It will be in the format: ak_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

​
Make your first API call

Now that you have your API key, let’s make your first request to list all assessments in your organization. 
curl -X GET "https://api.alfaone.com/api/v1/assessments" \
  -H "x-api-key: ak_live_your_api_key_here"

​
Response

{
  "assessments": [
    {
      "id": "7cac8eb9-09a8-4cec-b28e-dfc50db8d0f9",
      "name": "Software Engineer Assessment",
      "defaultQuestionFormat": "audio",
      "defaultAnswerFormat": "audio",
      "languages": ["en", "es"],
      "questionCount": 10,
      "inviteCount": 25,
      "createdAt": "2025-01-01T10:00:00.000Z",
      "updatedAt": "2025-01-02T15:30:00.000Z"
    }
  ]
}

​
Next Steps

Authentication

Learn more about API authentication and security

API Reference

Explore all available endpoints