Get My Applications

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

const options = {method: 'GET'};

fetch('https://api.example.com/api/v1/job-seekers/me/applications', 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/me/applications",
  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/me/applications"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

GET

api

job-seekers

applications

Get My Applications

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

const options = {method: 'GET'};

fetch('https://api.example.com/api/v1/job-seekers/me/applications', 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/me/applications",
  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/me/applications"

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

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

Endpoint

GET /api/v1/job-seekers/me/applications

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

This endpoint requires Job Seeker authentication.

Headers

Header	Value
Authorization	Bearer

Query Parameters

enum

Filter by application status. Can be repeated for multiple values. - PENDING - Under review - REVIEWED - Reviewed by company - SHORTLISTED - Added to shortlist - INTERVIEW_SCHEDULED - Interview scheduled - REJECTED - Application rejected - HIRED - Candidate hired - WITHDRAWN - Withdrawn by candidate

string

Search across job title, description, requirements, responsibilities, and company name (case-insensitive, substring match).

enum

Filter by application date range. - Last 24 hours - Last 7 days - Last 30 days - All time

number

Page number for pagination (default: 1).

number

Number of results per page (default: 20).

Response

{
  "success": true,
  "data": {
    "applications": [
      {
        "id": "uuid",
        "status": "PENDING",
        "appliedAt": "2025-02-20T10:00:00Z",
        "updatedAt": "2025-02-20T10:00:00Z",
        "directJob": {
          "id": "uuid",
          "title": "Software Engineer",
          "location": "Cairo, Egypt",
          "jobType": "FULL_TIME",
          "workPreference": "HYBRID",
          "company": {
            "id": "uuid",
            "name": "Tech Corp",
            "logoUrl": "https://..."
          }
        }
      }
    ],
    "total": 10,
    "page": 1,
    "limit": 20,
    "totalPages": 1
  },
  "message": "Applications retrieved successfully",
  "meta": {
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/applications",
    "method": "GET"
  }
}

Request Examples

Pagination only

# Page 1, 20 items (defaults)
GET /api/v1/job-seekers/me/applications

# Page 2, 10 items per page
GET /api/v1/job-seekers/me/applications?page=2&limit=10

Filter by status (single)

# All pending applications
GET /api/v1/job-seekers/me/applications?status=PENDING

# All rejected applications
GET /api/v1/job-seekers/me/applications?status=REJECTED

Filter by status (multi-value)

# Pending + Reviewed
GET /api/v1/job-seekers/me/applications?status=PENDING&status=REVIEWED

# Shortlisted + Interview scheduled + Hired
GET /api/v1/job-seekers/me/applications?status=SHORTLISTED&status=INTERVIEW_SCHEDULED&status=HIRED

# All non-rejected applications
GET /api/v1/job-seekers/me/applications?status=PENDING&status=REVIEWED&status=SHORTLISTED&status=INTERVIEW_SCHEDULED&status=HIRED

# All non-withdrawn applications
GET /api/v1/job-seekers/me/applications?status=PENDING&status=REVIEWED&status=SHORTLISTED&status=INTERVIEW_SCHEDULED&status=REJECTED&status=HIRED

Filter by search

# Search by job title or company name
GET /api/v1/job-seekers/me/applications?search=software+engineer

# Search for a specific company
GET /api/v1/job-seekers/me/applications?search=tech+corp

# Search by technology
GET /api/v1/job-seekers/me/applications?search=react

Filter by date range

# Last 24 hours
GET /api/v1/job-seekers/me/applications?dateApplied=Last+24+hours

# Last 7 days
GET /api/v1/job-seekers/me/applications?dateApplied=Last+7+days

# Last 30 days
GET /api/v1/job-seekers/me/applications?dateApplied=Last+30+days

Combined filters

# Pending applications in the last 24 hours
GET /api/v1/job-seekers/me/applications?status=PENDING&dateApplied=Last+24+hours

# Active (pending + reviewed) applications matching "engineer"
GET /api/v1/job-seekers/me/applications?search=engineer&status=PENDING&status=REVIEWED

# All filters combined
GET /api/v1/job-seekers/me/applications?search=senior&status=PENDING&status=REVIEWED&status=INTERVIEW_SCHEDULED&dateApplied=Last+7+days&page=1&limit=20

Error Responses

401 Unauthorized

{
  "success": false,
  "error": {
    "message": "Unauthorized",
    "statusCode": 401,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/applications",
    "method": "GET",
    "details": "Unauthorized"
  }
}

403 Forbidden

{
  "success": false,
  "error": {
    "message": "Forbidden resource",
    "statusCode": 403,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/applications",
    "method": "GET",
    "details": "Forbidden"
  }
}

400 Bad Request - Validation Error

{
  "success": false,
  "error": {
    "message": ["status must be a valid enum value"],
    "statusCode": 400,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/job-seekers/me/applications",
    "method": "GET",
    "details": "Bad Request"
  }
}

Authentication

Job Seeker

Skill Gap Analysis

Job Seeker Applications

CV

Work Experience

Education

Skills

Company

Direct Jobs

Company Applications

Interview Questions

Matching

Jobs

Get My Applications

Endpoint

Headers

Query Parameters

Response

Request Examples

Filter by status (single)

Filter by status (multi-value)

Filter by search

Filter by date range

Combined filters

Error Responses

401 Unauthorized

403 Forbidden

400 Bad Request - Validation Error

​Endpoint

​Headers

​Query Parameters

​Response

​Request Examples

​Pagination only

​Filter by status (single)

​Filter by status (multi-value)

​Filter by search

​Filter by date range

​Combined filters

​Error Responses

​401 Unauthorized

​403 Forbidden

​400 Bad Request - Validation Error

Endpoint

Headers

Query Parameters

Response

Request Examples

Pagination only

Filter by status (single)

Filter by status (multi-value)

Filter by search

Filter by date range

Combined filters

Error Responses

401 Unauthorized

403 Forbidden

400 Bad Request - Validation Error