Skip to main content
POST
/
api
/
public
/
v1
/
ai
/
generate-questions
Generate Interview Questions
curl --request POST \
  --url https://api.tidyhire.app/api/public/v1/ai/generate-questions \
  --header 'Content-Type: application/json' \
  --header 'x-tidyhire-api-key: <api-key>' \
  --data '
{
  "job_title": "<string>",
  "company_name": "<string>",
  "job_description": "<string>",
  "min_experience": 3,
  "max_experience": 5,
  "skills_required": [
    "<string>"
  ],
  "location": "<string>",
  "skills_good_to_have": [
    "<string>"
  ]
}
'
{
  "success": true,
  "data": [
    {
      "id": "a1b2c3d4e5f60123456789abcdef0123",
      "question": "Tell me about a production application you led. What architecture choices did you make?",
      "type": "verbal"
    }
  ]
}
This endpoint is AI-powered. It uses a large language model to generate tailored interview questions based on the job details, skills, and requirements provided.

Authorizations

x-tidyhire-api-key
string
header
required

Your Tidyhire API key

Body

application/json
job_title
string
required
company_name
string
required
job_description
string
required
min_experience
number
required

Minimum years of experience required.

Example:

3

max_experience
number
required

Maximum years of experience required.

Example:

5

seniority_level
enum<string>
required
Available options:
Entry,
Mid,
Senior,
Lead,
Principal,
Staff
work_type
enum<string>
required
Available options:
Remote,
On Site,
Hybrid
employment_type
enum<string>
required
Available options:
Full Time,
Part Time,
Contract,
Freelance
skills_required
string[]
required
location
string
skills_good_to_have
string[]
interview_duration
enum<string>
Available options:
15 Minutes,
30 Minutes,
1 hour,
2 hours

Response

Success.

success
boolean
Example:

true

data
object[]
Last modified on June 11, 2026