# HRIS API

## Retrieve job applications with optional filters

> Fetch job applications filtered by last status update date range and/or pipeline stage.\
> \- \`job\_application\_status\_start\` and \`job\_application\_status\_end\` filter by last status update date (UTC).\
> \- \`job\_application\_status\` filters by a specific pipeline stage.\
> If \`job\_application\_status\` is omitted, all statuses within the date range are returned.<br>

```json
{"openapi":"3.0.4","info":{"title":"Flo Recruit API","version":"1.0.0"},"servers":[{"url":"https://virtserver.swaggerhub.com/florecruit/FloApi/1.0.0","description":"SwaggerHub API Auto Mocking"}],"paths":{"/v1/job-applications":{"get":{"tags":["HRIS API"],"summary":"Retrieve job applications with optional filters","description":"Fetch job applications filtered by last status update date range and/or pipeline stage.\n- `job_application_status_start` and `job_application_status_end` filter by last status update date (UTC).\n- `job_application_status` filters by a specific pipeline stage.\nIf `job_application_status` is omitted, all statuses within the date range are returned.\n","operationId":"fetchHRISJobApplications","parameters":[{"name":"job_application_status_start","in":"query","description":"Filter candidates by last status update start date (UTC). Default is 30 days in the past.","required":false,"schema":{"type":"string","format":"date-time"}},{"name":"job_application_status_end","in":"query","description":"Filter candidates 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 - Incorrect request format or invalid status filter value. Check query parameters for correct date-time format and valid pipeline stage names.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_400"}}}},"401":{"description":"Unauthorized Access - Authentication failed or missing credentials. Reach out to Flo Recruit Support for access issues.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_401"}}}},"429":{"description":"Rate Limit Error - Too many requests in a given amount of time. Please retry after some time.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_429"}}}},"500":{"description":"Internal Server Error - An unexpected error occurred on the server.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_500"}}}}}}}},"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"}}},"inline_response_400":{"type":"object","properties":{"error":{"type":"string"}}},"inline_response_401":{"type":"object","properties":{"error":{"type":"string"}}},"inline_response_429":{"type":"object","properties":{"error":{"type":"string"}}},"inline_response_500":{"type":"object","properties":{"error":{"type":"string"}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.joinflo.com/api-reference/hris-api/hris-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.