---
title: "Retrieve PY Employee Work Statuses By Code"
slug: "retrieve-py-employee-work-statuses-by-code"
updated: 2026-05-26T12:53:14Z
published: 2026-05-26T12:53:48Z
canonical: "developers.cmicglobal.com/retrieve-py-employee-work-statuses-by-code"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://developers.cmicglobal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve PY Employee Work Statuses By Code

Get/hcm-rest-api/rest/1/pyempsubstatus

## Query Standards

### Finder

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

- Find By Date
- By Status Code

#### Find By Date

Recommended finder parameters. Refer to Query Parameters for example.

| Parameter | Description | Sample |
| --- | --- | --- |
| auditDate | Create or Update Date Time Filter | 2015-01-01 |

#### By Status Code

This is an optional finder for querying a specific Employee Work Status by Status Code.

| Parameter | Description | Sample |
| --- | --- | --- |
| /EmpsCode | The attribute is the Unique row ID | /hcm-rest-api/rest/1/pyempsubstatus/W |

SecurityHTTPType basic

Basic authentication

Query parametersfinderstringExamplefindByDate; auditDate=2015-01-01
limitintegerExample500
offsetintegerExample0
totalResultsbooleanExampletrue
orderBystringExampleEmpsCode

Responses200

OK

HeadersContent-TypestringExampleapplication/vnd.oracle.adf.resourcecollection+json
<select class='api-response-data' aria-label='Media type'><option value='baa6d599-5c4a-43d4-adb0-ee2f59a98f49'>application/json</option>
</select>

```json
{
  "items": [
    {
      "EmpsCode": "W",
      "EmpsDescription": "Working",
      "EmpsSeqNum": 10,
      "EmpsActiveStatus": "Y",
      "EmpsSysDefined": "Y",
      "EmpsIuCreateDate": "2022-09-05T01:36:12Z",
      "EmpsIuCreateUser": "DA",
      "EmpsIuUpdateDate": null,
      "EmpsIuUpdateUser": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsubstatus/W",
          "name": "pyempsubstatus",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsubstatus/W",
          "name": "pyempsubstatus",
          "kind": "item"
        }
      ]
    },
    {
      "EmpsCode": "V",
      "EmpsDescription": "On Leave",
      "EmpsSeqNum": 20,
      "EmpsActiveStatus": "Y",
      "EmpsSysDefined": "Y",
      "EmpsIuCreateDate": "2022-09-05T01:36:12Z",
      "EmpsIuCreateUser": "DA",
      "EmpsIuUpdateDate": null,
      "EmpsIuUpdateUser": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsubstatus/V",
          "name": "pyempsubstatus",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsubstatus/V",
          "name": "pyempsubstatus",
          "kind": "item"
        }
      ]
    },
    {
      "EmpsCode": "L",
      "EmpsDescription": "Temporary Layoff",
      "EmpsSeqNum": 30,
      "EmpsActiveStatus": "Y",
      "EmpsSysDefined": "Y",
      "EmpsIuCreateDate": "2022-09-05T01:36:12Z",
      "EmpsIuCreateUser": "DA",
      "EmpsIuUpdateDate": null,
      "EmpsIuUpdateUser": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsubstatus/L",
          "name": "pyempsubstatus",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsubstatus/L",
          "name": "pyempsubstatus",
          "kind": "item"
        }
      ]
    },
    {
      "EmpsCode": "F",
      "EmpsDescription": "FMLA",
      "EmpsSeqNum": 40,
      "EmpsActiveStatus": "Y",
      "EmpsSysDefined": "Y",
      "EmpsIuCreateDate": "2022-09-05T01:36:12Z",
      "EmpsIuCreateUser": "DA",
      "EmpsIuUpdateDate": null,
      "EmpsIuUpdateUser": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsubstatus/F",
          "name": "pyempsubstatus",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsubstatus/F",
          "name": "pyempsubstatus",
          "kind": "item"
        }
      ]
    },
    {
      "EmpsCode": "C",
      "EmpsDescription": "W/C",
      "EmpsSeqNum": 50,
      "EmpsActiveStatus": "Y",
      "EmpsSysDefined": "Y",
      "EmpsIuCreateDate": "2022-09-05T01:36:12Z",
      "EmpsIuCreateUser": "DA",
      "EmpsIuUpdateDate": null,
      "EmpsIuUpdateUser": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsubstatus/C",
          "name": "pyempsubstatus",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsubstatus/C",
          "name": "pyempsubstatus",
          "kind": "item"
        }
      ]
    }
  ],
  "count": 5,
  "hasMore": true,
  "limit": 5,
  "offset": 0,
  "links": [
    {
      "rel": "self",
      "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsubstatus",
      "name": "pyempsubstatus",
      "kind": "collection"
    }
  ]
}
```

object