> ## Documentation Index
> Fetch the complete documentation index at: https://careerk.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get My Applications

> Retrieve all job applications submitted by the authenticated job seeker

## Endpoint

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

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

<Note>This endpoint requires **Job Seeker authentication**.</Note>

## Headers

| Header        | Value                 |
| ------------- | --------------------- |
| Authorization | Bearer {access_token} |

## Query Parameters

<ParamField query="status" type="enum" optional>
  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
</ParamField>

<ParamField query="search" type="string" optional>
  Search across job title, description, requirements, responsibilities, and company name (case-insensitive, substring match).
</ParamField>

<ParamField query="dateApplied" type="enum" optional>
  Filter by application date range. - `Last 24 hours` - `Last 7 days` - `Last 30 days` - `All time`
</ParamField>

<ParamField query="page" type="number" optional>
  Page number for pagination (default: 1).
</ParamField>

<ParamField query="limit" type="number" optional>
  Number of results per page (default: 20).
</ParamField>

## Response

```json theme={null}
{
  "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

```bash theme={null}
# 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)

```bash theme={null}
# 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)

```bash theme={null}
# 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

```bash theme={null}
# 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

```bash theme={null}
# 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

```bash theme={null}
# 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

```json theme={null}
{
  "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

```json theme={null}
{
  "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

```json theme={null}
{
  "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"
  }
}
```