Get Question Set by ID - Nova Documentation

@nova-sdk/api

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",
});

curl -X GET "https://embed.nova.dweet.com/v1/jobs/job_abc123/question-sets/qs_abc123" \
  -H "Authorization: Bearer sk_test_..." \
  -H "X-Tenant-Id: acme-corp"

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

{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

GET

jobs

{jobId}

question-sets

{questionSetId}

@nova-sdk/api

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",
});

curl -X GET "https://embed.nova.dweet.com/v1/jobs/job_abc123/question-sets/qs_abc123" \
  -H "Authorization: Bearer sk_test_..." \
  -H "X-Tenant-Id: acme-corp"

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

{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "status": 123,
  "message": "<string>",
  "retryable": true,
  "traceId": "<string>",
  "details": [
    {
      "field": "<string>",
      "code": "<string>",
      "message": "<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.

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

Question set

questionSet

object

required

Show child attributes

Get Current Question Set Generate Criteria

​When to use

​Example response

​Related operations

Generate Questions

Get Current Question Set

Authorizations

Headers

Path Parameters

Response

When to use

Example response

Related operations