> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exterview.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Stack Ranking & Scoring Intelligence

> The AI ranking that sits on top of all interview rounds, a headline sellable surface.

<Warning>
  Blocked from publishing until the auth and gating checklist in [Authentication
  & Scopes](/get-started/authentication) lands. The configure and override
  operations additionally require `decisions:write` and must never sit in the
  default read tier.
</Warning>

## Purpose

Stack Ranking sits on top of every interview round and produces the ranked view of candidates for a job, with the justifications behind each score.

## Read back

| Type  | Operation                                              |
| ----- | ------------------------------------------------------ |
| Query | `jobStackRank(jobId, perPage, pageNumber)`             |
| Query | `jobLeaderboard(jobId, stage, weights, limit, offset)` |
| Query | `leaderboardRoundDecisions(input)`                     |
| Query | `leaderboardCandidateDecisions(jobId)`                 |
| Query | `leaderboardAuditTrail(input)`                         |
| Query | `scoreJustifications(candidateId, interviewType)`      |
| Query | `scoringConfig`                                        |

## Configure and override (`decisions:write` scope only)

| Type     | Operation                          |
| -------- | ---------------------------------- |
| Mutation | `saveScoringConfig(input)`         |
| Mutation | `overrideRoundDecision(input)`     |
| Mutation | `overrideCandidateDecision(input)` |

<Warning>
  Decision overrides mutate the hiring audit trail. They require an explicit
  `decisions:write` scope and must never be granted by default.
</Warning>

## FAQs

<AccordionGroup>
  <Accordion title="What does stack ranking rank?">
    All candidates for a job, across their completed rounds, into one ordered leaderboard.
  </Accordion>

  <Accordion title="Can we see why a candidate scored the way they did?">
    Yes. `scoreJustifications` returns the reasoning behind a candidate's score
    for a given interview type.
  </Accordion>

  <Accordion title="Are score weights published?">
    The mechanism is public; the actual weights live in `scoringConfig` and your
    signed configuration, not in these docs.
  </Accordion>

  <Accordion title="What happens when someone overrides a decision?">
    The override is written to the hiring audit trail and requires the `decisions:write` scope. Nothing is silently changed.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Calibration" icon="scale-balanced" href="/monitor/calibration">
    How scores trace to rubric versions and recalibrate.
  </Card>

  <Card title="Auditability" icon="clipboard-list" href="/trust/auditability">
    How overrides and decisions are traced.
  </Card>
</CardGroup>