Skip to main content
GET
/
v1
/
jobs
/
criteria
@nova-sdk/api
import { Nova } from "@nova-sdk/api";

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

const result = await nova.jobs.criteria.getBatch([
  "job_abc123",
  "job_def456",
  "job_ghi789",
]);
{
  "items": [
    {
      "jobId": "<string>",
      "criteria": [
        {
          "id": "<string>",
          "text": "<string>",
          "importance": "MUST_HAVE",
          "order": 123
        }
      ]
    }
  ]
}

​
When to Use

Retrieve criteria for multiple jobs in a single request. Useful for:
  • Building dashboards that show criteria status across many jobs
  • Syncing criteria for all active jobs during initial integration
  • Reducing API calls when loading criteria for job listings
Use this endpoint instead of calling Get Criteria in a loop. It accepts up to 100 job IDs per request.

​
Handling Missing Jobs

Jobs without active criteria return criteria: null in the response. This lets you distinguish between “no criteria generated yet” and “job was not in the request.”

Get Criteria

Get criteria for a single job

Generate Criteria

Generate criteria from a job description

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.

Query Parameters

​
jobIds
string
required

Comma-separated list of job IDs (max 100)

Response

Batch criteria results

​
items
object[]
required

One entry per requested job ID, in the same order as the request