> For the complete documentation index, see [llms.txt](https://docs.joinflo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.joinflo.com/api-reference/hris-api/hris-api.md).

# HRIS API

## Retrieve job applications with optional filters

> 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.\
> &#x20; When omitted, all statuses within the date range are returned.<br>

```json
{"openapi":"3.0.3","info":{"title":"Flo Recruit HRIS API — Job Applications","version":"1.0.0"},"servers":[{"url":"https://api.florecruit.com","description":"Flo Recruit production API"}],"paths":{"/v1/job-applications":{"get":{"tags":["HRIS API"],"summary":"Retrieve job applications with optional filters","description":"Fetch job applications, optionally filtered by last-status-update date\nrange and/or pipeline stage.\n\n- `job_application_status_start` / `job_application_status_end` bound the\n  last status-update timestamp (UTC). If `_start` is omitted it defaults\n  to 30 days in the past.\n- `job_application_status` restricts results to a single pipeline stage.\n  When omitted, all statuses within the date range are returned.\n","operationId":"fetchHRISJobApplications","parameters":[{"name":"job_application_status_start","in":"query","description":"Filter by last status-update start date (UTC). Defaults to 30 days in the past.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"job_application_status_end","in":"query","description":"Filter by last status-update end date (UTC).","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"job_application_status","in":"query","description":"Filter by pipeline stage (e.g. Application Extended, Offer Accepted). Must be a step in an Active Pipeline Template.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK — successfully retrieved job applications matching the filter criteria.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/JobApplicationHRISResponse"}}}}},"400":{"description":"Bad Request — malformed query parameters or invalid status-filter value. Check date-time format and pipeline stage names.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized — authentication failed or session missing. Contact Flo Recruit Support for access issues.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Too Many Requests — rate limit exceeded. Retry after a short delay.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Internal Server Error — an unexpected error occurred on the server.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"JobApplicationHRISResponse":{"type":"object","properties":{"firstName":{"type":"string"},"lastName":{"type":"string"},"candidateId":{"type":"string","format":"uuid"},"email":{"type":"string","format":"email"},"phone":{"type":"string"},"applicationId":{"type":"string","format":"uuid"},"jobTitle":{"type":"string"},"jobId":{"type":"string","format":"uuid"},"department":{"type":"string"},"officeLocation":{"type":"string"},"employmentType":{"type":"string"},"jobApplicationStatuses":{"type":"array","items":{"$ref":"#/components/schemas/JobApplicationStatus"}},"position":{"type":"string"},"requisitionId":{"type":"string"},"startDate":{"type":"string","format":"date"},"salary":{"type":"integer"},"jobApplicationLastStatusUpdate":{"type":"string","format":"date-time"}}},"JobApplicationStatus":{"type":"object","properties":{"statusName":{"type":"string"},"statusUpdatedAt":{"type":"string","format":"date-time"}}},"Error":{"type":"object","properties":{"error":{"type":"string"}}}}}}
```