Get Scoring Job

Retrieve score results for a specific scoring job by ID

GET /v1/jobs/{jobId}/applications/{applicationId}/scoring-jobs/{scoringJobId}

@nova-sdk/api

TypeScript

import { Nova } from "@nova-sdk/api";

const nova = new Nova({
  apiKey: "sk_test_...",
  tenantId: "acme-corp",
});

const result = await nova.jobs.applications.scoringJobs.get({
  jobId: "job_abc123",
  applicationId: "app_xyz789",
  scoringJobId: "sj_abc123",
});

200

{
  "scoringJob": {
    "id": "<string>",
    "criteriaVersionId": "<string>",
    "jobId": "<string>",
    "applicationId": "<string>",
    "status": "pending",
    "isRescore": true,
    "score": 123,
    "assessment": {
      "verdict": "<string>",
      "strengths": [
        "<string>"
      ],
      "concerns": [
        "<string>"
      ],
      "interviewFocus": [
        "<string>"
      ]
    },
    "errorCode": "UNAUTHORIZED",
    "errorMessage": "<string>",
    "queuedAt": "2023-11-07T05:31:56Z",
    "startedAt": "2023-11-07T05:31:56Z",
    "completedAt": "2023-11-07T05:31:56Z",
    "failedAt": "2023-11-07T05:31:56Z"
  }
}

Retrieve score results by scoring job ID. Use this if you missed the webhook or need to re-fetch results.

Response States

Status	Description
pending	Queued or currently scoring
completed	Scoring finished successfully
failed	Scoring couldn’t be completed

Score (1-10)

Range	Meaning
9-10	Exceptional match. Verified must-have evidence.
7-8	Strong fit. Minor questions to explore.
5-6	Mixed signals or unverified must-haves.
3-4	Significant gaps.
1-2	Missing fundamental requirements.

Assessment Fields

Field	Description
verdict	2-3 sentence summary with hiring recommendation
strengths	Evidence-backed positive observations
concerns	Gaps or potential issues
interviewFocus	Suggested topics for interviews

Polling

Prefer webhooks. Polling uses your rate limit and adds latency.

Poll by hitting this endpoint every 3 seconds until status is completed or failed.

Results are stored indefinitely.

Authorizations

Authorization · string · header · required

Use Authorization: Bearer sk_test_* or Authorization: Bearer sk_live_*.

Headers

X-Tenant-Id · string · required

Your customer identifier. Tenants are auto-provisioned on first request.

Path Parameters

jobId · string · required

Your job identifier (external ID).

applicationId · string · required

Your application identifier (external ID).

scoringJobId · string · required

Scoring job ID.

Response

200

application/json

Scoring job

scoringJob · object · required

Show child attributes