Get Criteria

Retrieve the active screening criteria stored for a job

GET /v1/jobs/{jobId}/criteria

@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.criteria.list("job_abc123");

200

{
  "criteria": [
    {
      "id": "<string>",
      "text": "<string>",
      "order": 123,
      "createdAt": "2023-11-07T05:31:56Z"
    }
  ]
}

When to Use

Retrieve the current criteria stored for a job. Useful for:

• Displaying criteria in your UI for review
• Debugging scoring behavior
• Verifying criteria were stored correctly after generation
• Building admin tools to manage criteria

Example response

{
  "criteria": [
    {
      "id": "crit_a1b2c3d4e5f6",
      "text": "Strong proficiency in Go for backend development",
      "importance": "MUST_HAVE",
      "order": 0
    },
    {
      "id": "crit_f6e5d4c3b2a1",
      "text": "Experience with distributed systems",
      "importance": "PREFERRED",
      "order": 1
    }
  ]
}

Related Operations

Get Current Version

Get active criteria with version metadata

Add Criterion

Add a new criterion

Archive Criteria

Archive criteria when a job closes

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

Response

200

application/json

Active criteria

criteria · object[] · required

Show child attributes