Skip to main content
GET
/
v1
/
jobs
/
{jobId}
/
scoring-batches
/
{scoringBatchId}
Get scoring batch status
curl --request GET \
  --url https://embed.nova.dweet.com/v1/jobs/{jobId}/scoring-batches/{scoringBatchId} \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Tenant-Id: <x-tenant-id>'
{
  "batch": {
    "id": "<string>",
    "jobId": "<string>",
    "status": "PENDING",
    "totalJobs": 123,
    "completedJobs": 123,
    "failedJobs": 123,
    "createdAt": "2023-11-07T05:31:56Z",
    "completedAt": "2023-11-07T05:31:56Z"
  },
  "scoringJobs": [
    {
      "id": "<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"
    }
  ]
}
Get the current status of a scoring batch and the scoring jobs it contains.

​
Batch status values

StatusMeaning
PENDINGBatch created and waiting to start
IN_PROGRESSAt least one job has started
COMPLETEDAll jobs completed successfully
PARTIAL_FAILURESome jobs failed and some completed
FAILEDAll jobs failed

​
Example response

{
  "batch": {
    "id": "batch_id",
    "jobId": "job-123",
    "status": "IN_PROGRESS",
    "totalJobs": 2,
    "completedJobs": 1,
    "failedJobs": 0,
    "createdAt": "2025-12-14T10:30:45Z",
    "completedAt": null
  },
  "scoringJobs": [
    {
      "id": "scoring_job_id_1",
      "jobId": "job-123",
      "applicationId": "app-001",
      "status": "COMPLETED",
      "isRescore": false,
      "score": 7,
      "assessment": {
        "verdict": "Strong candidate with solid backend experience.",
        "strengths": [],
        "concerns": [],
        "interviewFocus": []
      },
      "errorCode": null,
      "errorMessage": null,
      "queuedAt": "2025-12-14T10:30:45Z",
      "startedAt": "2025-12-14T10:30:50Z",
      "completedAt": "2025-12-14T10:31:20Z",
      "failedAt": null
    }
  ]
}

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).

​
scoringBatchId
string
required

Scoring batch ID.

Response

Batch status

​
batch
object
required
​
scoringJobs
object[]
required