# 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"}}}}}}
```