Skip to main content

​
GET /api/jobs//candidates

Retrieve all candidates who have applied to a specific job posting. This endpoint returns a list of all candidate applications associated with the specified job ID.

​
Authentication

No authentication required for this endpoint.

​
Path parameters

​
job_id
string
required
The unique identifier of the job posting

​
Response

Returns an array of candidate objects.
​
id
string
Unique identifier for the candidate (8-character UUID)
​
job_id
string
The job posting ID this candidate applied to
​
name
string
Full name of the candidate
​
email
string
Email address of the candidate
​
skills
array
List of candidate skills
​
experience
integer
Years of professional experience
​
projects
string
Description of relevant projects
​
resume_text
string
Extracted resume text content
​
github_link
string
GitHub profile URL
​
linkedin_link
string
LinkedIn profile URL
​
interview_answers
array
Interview question responses
​
user_id
string
Associated registered user ID, if applicable

​
Request example

curl https://api.fairmatch.ai/api/jobs/abc123/candidates

​
Response example

[
  {
    "id": "xyz789ab",
    "job_id": "abc123",
    "name": "Jane Smith",
    "email": "[email protected]",
    "skills": ["Python", "React", "PostgreSQL"],
    "experience": 5,
    "projects": "E-commerce platform with 100K users | Real-time analytics dashboard",
    "resume_text": "Experienced full-stack engineer with expertise in...",
    "github_link": "https://github.com/janesmith",
    "linkedin_link": "https://linkedin.com/in/janesmith",
    "interview_answers": [],
    "user_id": null
  },
  {
    "id": "def456gh",
    "job_id": "abc123",
    "name": "John Doe",
    "email": "[email protected]",
    "skills": ["JavaScript", "Node.js", "MongoDB"],
    "experience": 3,
    "projects": "Real-time chat application | REST API microservices",
    "resume_text": "Software developer passionate about building scalable...",
    "github_link": "https://github.com/johndoe",
    "linkedin_link": "https://linkedin.com/in/johndoe",
    "interview_answers": [],
    "user_id": null
  }
]

​
Status codes

  • 200 - Successfully retrieved candidates list
  • 400 - Invalid job ID format
  • 500 - Internal server error

Build docs developers (and LLMs) love

Get started for freeTalk to us