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": "Senior Software Engineer",
  "company_name": "Acme Corp",
  "job_description": "We are looking for a Senior Software Engineer to join our team and build scalable backend services.",
  "experience_level": "5-8 Years",
  "seniority_level": "Senior",
  "work_type": "Remote",
  "employment_type": "Full Time",
  "skills_required": [
    "JavaScript",
    "Node.js",
    "MongoDB"
  ],
  "location": "New York, NY",
  "skills_good_to_have": [
    "TypeScript",
    "Redis"
  ],
  "interview_duration": "30 Minutes"
}
'
{
  "success": true,
  "data": [
    {
      "id": "a1b2c3d4e5f60123456789abcdef0123",
      "question": "Tell me about a production application you led. What architecture choices did you make?",
      "task": null,
      "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

The title of the job position.

Minimum string length: 1
Example:

"Senior Software Engineer"

​
company_name
string
required

The name of the company hiring for this role.

Minimum string length: 1
Example:

"Acme Corp"

​
job_description
string
required

A detailed description of the job role and responsibilities.

Minimum string length: 1
Example:

"We are looking for a Senior Software Engineer to join our team and build scalable backend services."

​
experience_level
enum<string>
required

Required experience level.

Available options:
Fresher,
1-2 Years,
2-5 Years,
5-8 Years,
8-12 Years,
Above 12 Years
Example:

"5-8 Years"

​
seniority_level
enum<string>
required

Seniority level for the role.

Available options:
Entry,
Mid,
Senior,
Lead,
Principal,
Staff
Example:

"Senior"

​
work_type
enum<string>
required

Work arrangement type.

Available options:
Remote,
On Site,
Hybrid
Example:

"Remote"

​
employment_type
enum<string>
required

Type of employment.

Available options:
Full Time,
Part Time,
Contract,
Freelance
Example:

"Full Time"

​
skills_required
string[]
required

List of required skills. Minimum 3 skills.

Minimum array length: 3
Example:
["JavaScript", "Node.js", "MongoDB"]
​
location
string
default:""

Job location.

Example:

"New York, NY"

​
skills_good_to_have
string[]

List of preferred skills.

Example:
["TypeScript", "Redis"]
​
interview_duration
enum<string>
default:30 Minutes

Duration of the interview.

Available options:
15 Minutes,
30 Minutes,
1 hour,
2 hours
Example:

"30 Minutes"

Response

Interview questions generated successfully.

​
success
boolean
Example:

true

​
data
object[]

AI-generated interview questions tailored to the job requirements. Each question is either verbal or task-based (coding or general).

Last modified on February 19, 2026