Get All Job Seeker Profiles

Retrieve a paginated list of job seeker profiles with optional filters

GET /api/v1/job-seekers

Get All Job Seeker Profiles

cURL

curl --request GET \
  --url https://api.example.com/api/v1/job-seekers

import requests

url = "https://api.example.com/api/v1/job-seekers"

response = requests.get(url)

print(response.text)

const options = {method: 'GET'};

fetch('https://api.example.com/api/v1/job-seekers', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/job-seekers",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/job-seekers"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/job-seekers")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/job-seekers")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

200

{
  "jobSeekers": [
    {
      "firstName": "<string>",
      "lastName": "<string>",
      "profileImageUrl": {},
      "profile": {
        "jobSeekerId": "<string>",
        "title": "<string>",
        "location": "<string>",
        "availabilityStatus": {},
        "workPreference": {},
        "preferredJobTypes": [
          {}
        ],
        "yearsOfExperience": 123,
        "linkedinUrl": {},
        "portfolioUrl": {},
        "githubUrl": {},
        "summary": {},
        "expectedSalary": {},
        "cvEmail": "<string>",
        "cvScore": 123
      },
      "skills": [
        {
          "name": "<string>",
          "verified": true
        }
      ]
    }
  ],
  "total": 123,
  "page": 123,
  "limit": 123,
  "totalPages": 123
}

Endpoint

GET /api/v1/job-seekers

Base URL: http://localhost:3000/api/v1

This endpoint is public and does not require authentication.

Query Parameters

availabilityStatus · enum

Filter by availability status. Can be repeated for multiple values. - OPEN_TO_WORK - Actively looking - NOT_LOOKING - Not looking - PASSIVELY_LOOKING - Open to opportunities

location · string

Filter by location (partial string match, case-insensitive).

workPreference · enum

Filter by work preference. Can be repeated for multiple values. - REMOTE - Remote work - ONSITE - On-site work - HYBRID - Hybrid work - ANY - No preference

minYearsOfExperience · number

Minimum years of experience (inclusive).

maxYearsOfExperience · number

Maximum years of experience (inclusive).

preferredJobTypes · enum[]

Filter by preferred job types. Can be repeated for multiple types. - FULL_TIME - PART_TIME - CONTRACT - INTERNSHIP - FREELANCE

search · string

Search across name, job title, and skills (case-insensitive, substring match).

maxNoticePeriod · number

Maximum notice period in days.

page · number

Page number (default: 1).

limit · number

Items per page (default: 20).

Request Examples

# Basic filtering
GET /api/v1/job-seekers?location=London&workPreference=REMOTE&availabilityStatus=OPEN_TO_WORK&minYearsOfExperience=2&page=1&limit=10

# Search by name, title, or skills
GET /api/v1/job-seekers?search=software+engineer

# Multi-value filters
GET /api/v1/job-seekers?availabilityStatus=OPEN_TO_WORK&availabilityStatus=IMMEDIATE&workPreference=REMOTE&workPreference=HYBRID

Response

Success Response (200 OK)

{
  "success": true,
  "data": {
    "jobSeekers": [
      {
        "firstName": "Jeffrey",
        "lastName": "Martin",
        "profileImageUrl": null,
        "profile": {
          "jobSeekerId": "7933b735-4212-4dbe-8843-ce4dd5961076",
          "title": "Rust Developer",
          "location": "London, UK",
          "availabilityStatus": "NOT_LOOKING",
          "workPreference": "REMOTE",
          "preferredJobTypes": ["PART_TIME", "INTERNSHIP", "CONTRACT"],
          "yearsOfExperience": 20,
          "linkedinUrl": null,
          "portfolioUrl": null,
          "githubUrl": null,
          "summary": "Experienced Rust developer specializing in backend systems.",
          "expectedSalary": 5000,
          "cvEmail": "[e-mail]",
          "cvScore": 87
        },
        "skills": [
          {
            "name": "Rust",
            "verified": true
          },
          {
            "name": "Docker",
            "verified": false
          }
        ]
      },
      {
        "firstName": "Sandra",
        "lastName": "Morgan",
        "profileImageUrl": null,
        "profile": {
          "jobSeekerId": "1245d82c-a49a-4ec5-b4dd-ff5e770c3b2b",
          "title": "DevOps Engineer",
          "location": "Berlin, Germany",
          "availabilityStatus": "NOT_LOOKING",
          "workPreference": "REMOTE",
          "preferredJobTypes": ["FREELANCE", "PART_TIME", "INTERNSHIP"],
          "yearsOfExperience": 20,
          "linkedinUrl": null,
          "portfolioUrl": null,
          "githubUrl": null,
          "summary": "Experienced DevOps Engineer with expertise in cloud infrastructure.",
          "expectedSalary": 6000,
          "cvEmail": "[e-mail]",
          "cvScore": 92
        },
        "skills": [
          {
            "name": "AWS",
            "verified": true
          },
          {
            "name": "Kubernetes",
            "verified": true
          }
        ]
      }
    ],
    "total": 1032,
    "page": 1,
    "limit": 20,
    "totalPages": 52
  },
  "message": "Job seeker profiles retrieved successfully",
  "meta": {
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers",
    "method": "GET"
  }
}

Response Fields

jobSeekers · array

Array of job seeker profile summaries.

Show Job Seeker Object

firstName · string

Job seeker’s first name.

lastName · string

Job seeker’s last name.

profileImageUrl · string | null

URL to the job seeker’s profile image.

profile · object

Public profile information.

Show Profile Properties

jobSeekerId · string

Unique profile identifier (UUID).

title · string

Current job title.

location · string

Location.

availabilityStatus · enum

Current availability status.

workPreference · enum

Work preference.

preferredJobTypes · enum[]

Preferred job types.

yearsOfExperience · number

Years of experience.

linkedinUrl · string | null

LinkedIn profile URL.

portfolioUrl · string | null

Portfolio website URL.

githubUrl · string | null

GitHub profile URL.

summary · string | null

Short professional summary of the job seeker.

expectedSalary · number | null

Expected monthly salary.

cvEmail · string

Email used in CV submission.

cvScore · number

AI-generated or system CV score (0–100).

skills · array

List of skills associated with the job seeker.

Show Skill Object

name · string

Skill name (e.g., AWS, Docker, Rust).

verified · boolean

Indicates whether the skill is verified.

total · number

Total number of job seekers matching the filters.

page · number

Current page number.

limit · number

Items per page.

totalPages · number

Total number of pages.

Filtering Examples

Filter by Location

GET /api/v1/job-seekers?location=London

Search

GET /api/v1/job-seekers?search=software

Searches across firstName, lastName, profile.title, and skill.name.

Filter by Work Preference (Multi)

GET /api/v1/job-seekers?workPreference=REMOTE&workPreference=HYBRID

Filter by Availability Status (Multi)

GET /api/v1/job-seekers?availabilityStatus=OPEN_TO_WORK&availabilityStatus=IMMEDIATE

Filter by Experience Range

GET /api/v1/job-seekers?minYearsOfExperience=2&maxYearsOfExperience=5

Filter by Job Types

GET /api/v1/job-seekers?preferredJobTypes=FULL_TIME&preferredJobTypes=CONTRACT

Combine Multiple Filters

GET /api/v1/job-seekers?location=Berlin&workPreference=REMOTE&workPreference=HYBRID&availabilityStatus=OPEN_TO_WORK&minYearsOfExperience=3

Error Responses

400 Bad Request - Validation Error

{
  "success": false,
  "error": {
    "message": ["Invalid query parameters"],
    "statusCode": 400,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers",
    "method": "GET",
    "details": "Bad Request"
  }
}

Notes

Public Profiles Only: This endpoint returns only public profile information. Sensitive data like email, phone are only available in the detailed profile endpoint.

Optimize Queries: Use specific filters to reduce the number of results and improve response time.