---
title: "GetVacantPositions"
id: "getvacantpositions"
project: "EHR User Guide"
url: "https://help.cloud5.com.au/articles/ehr-user-guide/getvacantpositions"
updated: 2026-10-19T00:52:39Z
---

# GetVacantPositions

The vacant position details are retrieved for the date range entered.

Below are the request restrictions available when retrieving the vacant position details returned by the EmpowerStandardExtract web service via 'GetVacantPositions'.

| **Request Element** | **Options** | **Default** |
| --- | --- | --- |
| Restriction/DateRangeFrom | Date (YYYYMMDD) |  |
| Restriction/DateRangeTo | Date (YYYYMMDD) |  |
| Restriction/ExcludeActivelyRecruited | yes <br>no |  |
| Restriction/IncludeContractExpires | yes <br>no |  |
| Restriction/ExcludeNonFunded | yes <br>no |  |
| Restriction/DeletedPositions | include <br>exclude | exclude |

The 'Restriction/DateRangeFrom' and 'Restriction/DateRangeTo' elements filter positions active within a specific date range. If no date range is provided, positions active as of the current date are returned.

To exclude positions that are being actively recruited, set the 'Restriction/ExcludeActivelyRecruited' element to 'yes'.

To include positions with expiring contracts, set the 'Restriction/IncludeContractExpires' element to 'yes'.

To exclude non-funded positions, set the 'Restriction/ExcludeNonFunded' element to 'yes'.

To include deleted positions, set the 'Restriction/DeletedPositions' element to 'include'. By default, deleted positions are not included in the extract.

Below is an example where vacant positions are retrieved for a specific date range with all restriction parameters applied:

![Screenshot of example where vacant positions are retrieved for a specific date range with all restriction parameters applied](/resources/Storage/ehr-user-guide/getvacantpositions/GetVacantPositions-2026-03-23-1.png)

Below is an example where vacant positions are retrieved without a date range, using only the filtering restriction parameters:

![Screenshot of example where vacant positions are retrieved without a date range, using only the filtering restriction parameters](/resources/Storage/ehr-user-guide/getvacantpositions/GetVacantPositions-2026-03-23-2.png)

Below are the position fields returned by the EmpowerStandardExtract web service via 'GetVacantPositions'.

| **Element** | **Default Screen Title** |
| --- | --- |
| VacantPosition/PositionNumber | Position Number |
| VacantPosition/Details/PositionAbbreviation | Position Abbreviation |
| VacantPosition/Details/PositionTitle | Position Title |
| VacantPosition/Details/EstablishmentAction/Code | Establishment Action Code |
| VacantPosition/Details/EstablishmentAction/Description | Establishment Action Description |
| VacantPosition/Details/EstablishmentAction/Abbreviation | Establishment Action Abbreviation |
| VacantPosition/Details/Date | Position Status Date |
| VacantPosition/Details/Budgeted/Code | Budgeted Code |
| VacantPosition/Details/Budgeted/Description | Budgeted Description |
| VacantPosition/Details/FteAllocation | FTE Allocation |
| VacantPosition/Details/BudgetCategory/Code | Budget Category Code |
| VacantPosition/Details/BudgetCategory/Description | Budget Category Description |
| VacantPosition/Details/BudgetCategory/Abbreviation | Budget Category Abbreviation |
| VacantPosition/Details/SpecialRequirements | Special Requirements |
| VacantPosition/Details/Narrative | Narrative |
| VacantPosition/Details/JobNumber/Code | Job Number Code |
| VacantPosition/Details/JobNumber/Description | Job Number Description |
| VacantPosition/Details/ANZSCO/Code | ANZSCO Code |
| VacantPosition/Details/ANZSCO/Description | ANZSCO Description |
| VacantPosition/Details/ANZSCO/Abbreviation | ANZSCO Abbreviation |
| VacantPosition/Details/ANZSIC/Code | ANZSIC Code |
| VacantPosition/Details/ANZSIC/Description | ANZSIC Description |
| VacantPosition/Details/ANZSIC/Abbreviation | ANZSIC Abbreviation |
| VacantPosition/Details/OccupationalCategory/Code | Occupational Category Code |
| VacantPosition/Details/OccupationalCategory/Description | Occupational Category Description |
| VacantPosition/Details/OccupationalCategory/Abbreviation | Occupational Category Abbreviation |
| VacantPosition/Details/Discipline/Code | Discipline Code |
| VacantPosition/Details/Discipline/Description | Discipline Description |
| VacantPosition/Details/Discipline/Abbreviation | Discipline Abbreviation |
| VacantPosition/Details/Stream/Code | Stream Code |
| VacantPosition/Details/Stream/Description | Stream Description |
| VacantPosition/Details/Stream/Abbreviation | Stream Abbreviation |
| VacantPosition/Details/Authority/Code | Authority Code |
| VacantPosition/Details/Authority/Description | Authority Description |
| VacantPosition/Details/Authority/Abbreviation | Authority Abbreviation |
| VacantPosition/Details/DelegationNumber/Code | Delegation Number Code |
| VacantPosition/Details/DelegationNumber/Description | Delegation Number Description |
| VacantPosition/Details/DelegationNumber/Abbreviation | Delegation Number Abbreviation |
| VacantPosition/Details/UserField1/Code | User Field 1 Code |
| VacantPosition/Details/UserField1/Description | User Field 1 Description |
| VacantPosition/Details/UserField1/Abbreviation | User Field 1 Abbreviation |
| VacantPosition/Details/UserField2/Code | User Field 2 Code |
| VacantPosition/Details/UserField2/Description | User Field 2 Description |
| VacantPosition/Details/UserField2/Abbreviation | User Field 2 Abbreviation |
| VacantPosition/ContractExpiryDate | Contract Expiry Date |
| VacantPosition/ActivelyRecruitedValue | Actively Recruited Value |

| Next topic<br><br>[Schema](/articles/ehr-user-guide/schema) |
| --- |

© 2023 Fusion5. All rights reserved.