Retrieve HR Position By Code

Published on Oct 7, 2026

Prev Next

Get

/hcm-rest-api/rest/1/HrPositionsMaster/

Query Standards

Finder

Following row finders are available for data filtering and optimizing request performance.

PosFinder
By UUID

PosFinder

Recommended finder parameters. Refer to Query Parameters for example.

Parameter	Description	Sample
ActiveFlag	Positions Active Flag (Y/N)	Y
Code	Positions Code	POS1
CreateDateFrom	Start create Date of Position	2026-05-10
CreateDateTo	End create Date of Position	2026-05-20

By UUID

This is an optional finder for querying a specific Position by row ID.

Parameter	Description	Sample
/VUUID	The VUuid attribute is the Unique row ID	/hcm-rest-api/rest/1/HrPositionsMaster/VUUID

Security

HTTP

Type basic

Basic authentication

Query parameters

finder

string

ExamplePosFinder;Code=ENG001,ActiveFlag=Y

string

ExamplePosCode = 'SE-FTA'

onlyData

boolean

Exampletrue

limit

integer

Example100

Responses

200

"{\r\n    \"items\": [\r\n        {\r\n            \"PosActiveFlag\": \"Y\",\r\n            \"PosAllowEtimeEntryFlag\": null,\r\n            \"PosCode\": \"SE-FTA\",\r\n            \"PosCtrlPos\": null,\r\n            \"PosDefaultJobTitle\": null,\r\n            \"PosDescription\": \"Software Engineer L1\",\r\n            \"PosEeoClass\": \"008\",\r\n            \"PosEeoClassDesc\": \"Personnel & Labor Relation Mgr\",\r\n            \"PosExpiryDate\": null,\r\n            \"PosFlsaExemptFlag\": \"N\",\r\n            \"PosFlsaExemptFlagDesc\": \"Non-Exempt\",\r\n            \"PosGradeCode\": null,\r\n            \"PosGradeDesc\": null,\r\n            \"PosHrpdCode\": null,\r\n            \"PosHrpdDesc\": null,\r\n            \"PosHrweCode\": null,\r\n            \"PosHrweDesc\": null,\r\n            \"PosIuCreateDate\": \"2026-05-12T10:09:37-04:00\",\r\n            \"PosIuCreateUser\": \"FARHA\",\r\n            \"PosIuUpdateDate\": \"2026-05-12T14:44:16-04:00\",\r\n            \"PosIuUpdateUser\": \"FARHA\",\r\n            \"PosJobSummary\": null,\r\n            \"PosLastUpdDate\": \"2026-05-12T14:44:16-04:00\",\r\n            \"PosResponsibilities\": null,\r\n            \"PosSafeCertFlag\": \"Y\",\r\n            \"PosShortDesc\": \"SE\",\r\n            \"PosStatusCode\": null,\r\n            \"PosTradeCode\": null,\r\n            \"PosTrainDesc\": \"Regular Employee\",\r\n            \"PosTrainType\": \"0\",\r\n            \"PosUser\": \"FARHA\",\r\n            \"PosVUuid\": \"51A00F0962A33326E0630B811DACBD9B\"\r\n        }\r\n    ],\r\n    \"count\": 1,\r\n    \"hasMore\": false,\r\n    \"limit\": 25,\r\n    \"offset\": 0,\r\n    \"links\": [\r\n        {\r\n            \"rel\": \"self\",\r\n            \"href\": \"http://dev6v12.cmic.ca:7011/cmicdevv12/hcm-rest-api/rest/1/HrPositionsMaster\",\r\n            \"name\": \"HrPositionsMaster\",\r\n            \"kind\": \"collection\"\r\n        }\r\n    ]\r\n}"

string