Authentication

TalentScreen API uses Bearer token authentication. All API requests must include a valid API token in the Authorization header.

Generating API Tokens

Generate API tokens from your dashboard under Settings > API Access. Each token has specific permissions and can be revoked at any time.

Using Tokens

Include your token in the Authorization header as a Bearer token with every request.

GET /api/v1/exams HTTP/1.1
Host: talentscreens.org
Authorization: Bearer sk_live_abc123xyz789...
Content-Type: application/json

Token Scopes

Authentication Errors

Invalid or missing tokens return 401 Unauthorized. Insufficient permissions return 403 Forbidden. Check the error response for details.

{
  "error": {
    "code": "invalid_token",
    "message": "The API token provided is invalid or expired",
    "status": 401
  }
}