Score Batch

Submit multiple applications for scoring in a single request

POST /v1/jobs/{jobId}/scoring-batches

@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.scoringBatches.submit({
  jobId: "job_abc123",
  body: {
    jobDescription: "We are looking for a senior engineer...",
    applications: [
      {
        applicationId: "app_001",
        resume: { type: "url", url: "https://example.com/resumes/candidate-1.pdf" },
      },
      {
        applicationId: "app_002",
        resume: { type: "url", url: "https://example.com/resumes/candidate-2.pdf" },
      },
    ],
  },
});

202

{
  "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"
  },
  "scoringJobIds": [
    "<string>"
  ]
}

Submit multiple applications for scoring in a single request. Results are delivered individually via webhook.

Request

TypeScript SDK

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

const nova = new Nova({
  apiKey: process.env.NOVA_API_KEY!,
  tenantId: 'acme-corp',
});

const { batch, scoringJobIds } = await nova.jobs.scoringBatches.submit({
  jobId: 'job-123',
  body: {
    jobDescription: 'We are looking for a Senior Backend Engineer with 5+ years of experience in Node.js and TypeScript...',
    roleKnowledge: "Team values candidates who've built systems from scratch. Strong preference for distributed systems experience over frontend-heavy backgrounds.",
    applications: [
      {
        applicationId: 'app-001',
        resume: { type: 'url', url: 'https://storage.example.com/resumes/001.pdf' },
      },
      {
        applicationId: 'app-002',
        resume: { type: 'text', content: '# Jane Smith\n\nSenior Backend Engineer with 7 years of experience...' },
        applicationData: {
          applicationAnswers: [
            { question: 'Are you eligible to work in the UK?', answer: 'Yes' },
          ],
          context: 'Internal recruiter note: Strong referral from engineering lead. Candidate expressed interest in platform team specifically.',
        },
      },
    ],
  },
});

Include jobDescription at the batch level. It applies to all applications in the batch. See Data Retention for storage details.

Limits

• 1 to 25 applications per request

Response

The API returns 202 Accepted.

{
  "batch": {
    "id": "cmlz26em4002cwp61t7ukh3lb",
    "jobId": "job-123",
    "status": "pending",
    "totalJobs": 2,
    "completedJobs": 0,
    "failedJobs": 0,
    "createdAt": "2025-12-14T10:30:45Z",
    "completedAt": null
  },
  "scoringJobIds": ["cmlz26dl3001bwp61r8sjf2ka", "cmlz26dl3001bwp61r8sjf2kb"]
}

Next step

Use Get Batch Status to poll batch progress if you need it.

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

Body

application/json

applications · object[] · required

Required array length: 1 - 25 elements

Show child attributes

jobDescription · string · required

Required string length: 1 - 50000

jobTitle · string

Minimum string length: 1

companyName · string

Minimum string length: 1

roleKnowledge · string

Required string length: 1 - 15000

Response

202

application/json

Accepted

batch · object · required

Show child attributes

scoringJobIds · string[] · required