Get Question Set by ID

Retrieve a specific question set by its ID

GET /v1/jobs/{jobId}/question-sets/{questionSetId}

@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.questionSets.get({
  jobId: "job_abc123",
  questionSetId: "qs_abc123",
});

200

{
  "questionSet": {
    "id": "<string>",
    "jobId": "<string>",
    "questions": [
      {
        "id": "<string>",
        "question": "<string>",
        "options": [
          "<string>"
        ],
        "hint": "<string>"
      }
    ],
    "expiresAt": "2023-11-07T05:31:56Z",
    "guidance": "<string>"
  }
}

Retrieve a specific question set by its ID. Use this when you have stored the questionSetId from a previous generation response and need to fetch the questions again.

When to use

• You stored the questionSetId and need to re-display questions
• You want to verify the questions before passing answers to criteria generation
• You need to check expiresAt to confirm the question set is still valid

Expired question sets are cleaned up per the Data Retention policy.

Example response

{
  "questionSet": {
    "id": "cmlz26fn5003dwp61u6vmj4mc",
    "jobId": "job-123",
    "questions": [
      {
        "id": "q1",
        "selectionType": "single",
        "question": "What level of seniority are you targeting?",
        "options": ["Junior", "Mid", "Senior"],
        "hint": "Helps calibrate experience requirements"
      }
    ],
    "guidance": "Answer these questions to calibrate criteria generation.",
    "expiresAt": "2026-12-14T11:30:45Z"
  }
}

If the question set doesn’t exist, the endpoint returns a 404 error with code QUESTION_SET_NOT_FOUND.

Related operations

Generate Questions

Generate a new question set for a job

Get Current Question Set

Retrieve the latest question set without knowing the ID

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

questionSetId · string · required

Question set ID.

Response

200

application/json

Question set

questionSet · object · required

Show child attributes