Get Leaderboard

Retrieve candidate rankings and scores for a specific job

POST /graphql

Get Leaderboard

cURL

curl --request POST \
  --url https://api.example.com/graphql \
  --header 'Content-Type: application/json' \
  --data '
{
  "jobId": "<string>",
  "organizationId": "<string>",
  "leaderboardtype": "<string>"
}
'

200 OK

{
  "data": {
    "getLeaderboard": {
      "rows": [
        { "name": "Manav Gupta", "value": 87.5 },
        { "name": "Rakesh", "value": 79.0 },
        { "name": "Priya Sharma", "value": 76.5 },
        { "name": "Arjun Patel", "value": 72.0 },
        { "name": "Sneha Kumar", "value": 68.5 }
      ]
    }
  }
}

Overview

Get a ranked leaderboard of candidates for a job, sorted by their scores. Supports both AI-generated and manual scoring.

Endpoint

POST /graphql
Content-Type: application/json

GraphQL Query

query getLeaderboard($input: InputTypeLeaderBoard!) {
  getLeaderboard(input: $input) {
    rows {
      name
      value
    }
  }
}

Request Parameters

jobId · string · required

Unique identifier of the job

organizationId · string · required

Organization identifier

leaderboardtype · string · required

Type of leaderboard: “ai” for AI-generated scores or “manual” for manual reviewer scores

Request Example

cURL

curl -X POST https://api.exterview.ai/graphql \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query getLeaderboard($input: InputTypeLeaderBoard!) { getLeaderboard(input: $input) { rows { name value } } }",
    "variables": {
      "input": {
        "jobId": "68c42431b9f38f8c24fbc91f",
        "leaderboardtype": "ai",
        "organizationId": "68a5bac35f995060754e2425"
      }
    }
  }'

Response

data · object

Show data properties

getLeaderboard · object

Show getLeaderboard properties

rows · array

Array of leaderboard entries, sorted by score (descending)

Show Leaderboard Row

name · string

Candidate’s full name

value · number

Candidate’s score (0-100)

Response Example

200 OK

{
  "data": {
    "getLeaderboard": {
      "rows": [
        { "name": "Manav Gupta", "value": 87.5 },
        { "name": "Rakesh", "value": 79.0 },
        { "name": "Priya Sharma", "value": 76.5 },
        { "name": "Arjun Patel", "value": 72.0 },
        { "name": "Sneha Kumar", "value": 68.5 }
      ]
    }
  }
}