---
title: "Retrieve job applications with optional filters"
method: GET
path: "/v1/job-applications"
tags: ["HRIS API"]
---

# Retrieve job applications with optional filters

`GET /v1/job-applications`

## Request

- Base URL: `https://api.florecruit.com`
- URL: `https://api.florecruit.com/v1/job-applications`
- Auth: none declared

Fetch job applications, optionally filtered by last-status-update date
range and/or pipeline stage.

- `job_application_status_start` / `job_application_status_end` bound the
  last status-update timestamp (UTC). If `_start` is omitted it defaults
  to 30 days in the past.
- `job_application_status` restricts results to a single pipeline stage.
  When omitted, all statuses within the date range are returned.

## Query parameters

- `job_application_status_start` string, date-time
- `job_application_status_end` string, date-time
- `job_application_status` string

## Response `200`

OK — successfully retrieved job applications matching the filter criteria.

- JobApplicationHRISResponse[]
  - `firstName` string
  - `lastName` string
  - `candidateId` string, uuid
  - `email` string, email
  - `phone` string
  - `applicationId` string, uuid
  - `jobTitle` string
  - `jobId` string, uuid
  - `department` string
  - `officeLocation` string
  - `employmentType` string
  - `jobApplicationStatuses` JobApplicationStatus[]
    - `statusName` string
    - `statusUpdatedAt` string, date-time
  - `position` string
  - `requisitionId` string
  - `startDate` string, date
  - `salary` integer
  - `jobApplicationLastStatusUpdate` string, date-time

## Other responses

- `400`: Bad Request — malformed query parameters or invalid status-filter value. Check date-time format and pipeline stage names.
- `401`: Unauthorized — authentication failed or session missing. Contact Flo Recruit Support for access issues.
- `429`: Too Many Requests — rate limit exceeded. Retry after a short delay.
- `500`: Internal Server Error — an unexpected error occurred on the server.

---

[API](https://skmtc.dev/joinflo/apis/flo-recruit-hris-api-job-applications.md) - [All operations](https://skmtc.dev/joinflo/apis/flo-recruit-hris-api-job-applications/llms.txt) - [OpenAPI document](https://skmtc.dev/joinflo/apis/flo-recruit-hris-api-job-applications/revisions/c8fd3461ce6f?raw)