---
title: "Retrieve Security Groups By Code"
slug: "retrieve-security-groups-by-code"
updated: 2026-05-26T12:53:14Z
published: 2026-05-26T12:53:48Z
canonical: "developers.cmicglobal.com/retrieve-security-groups-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 Security Groups By Code

Get/hcm-rest-api/rest/1/vertexloccity

## Query Standards

### Finder

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

- Find By Date
- By ESG Code

#### Find By Date

Recommended finder parameters. Refer to Query Parameters for example.

| Parameter | Description | Sample |
| --- | --- | --- |
| auditDate | Create or Update Date Time Filter | 2014-12-20 |

#### By ESG Code

This is an optional finder for querying a specific Security Group by ESG Code.

| Parameter | Description | Sample |
| --- | --- | --- |
| /ESGCODE | The ESG Code attribute is the Unique row ID | /hcm-rest-api/rest/1/pyempsecgrp/EXEC |

SecurityHTTPType basic

Basic authentication

Query parameterslimitintegerExample500
offsetintegerExample0
totalResultsbooleanExampletrue
finderstringExampleVertexLocCityFinder;ZipCodeVar=64802
orderBystringExampleLoczipcodestart:desc

Responses200

OK

HeadersContent-TypestringExampleapplication/vnd.oracle.adf.resourcecollection+json
<select class='api-response-data' aria-label='Media type'><option value='5058b777-fe81-4048-b9e2-2b6ed1bd6874'>application/json</option>
</select>

```json
{
  "items": [
    {
      "EsgCode": "CONF",
      "EsgName": "Confidential Payroll",
      "EsgIuCreateDate": "2015-05-11T13:13:22Z",
      "EsgIuCreateUser": "ADWAIT",
      "EsgIuUpdateDate": null,
      "EsgIuUpdateUser": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsecgrp/CONF",
          "name": "pyempsecgrp",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsecgrp/CONF",
          "name": "pyempsecgrp",
          "kind": "item"
        }
      ]
    },
    {
      "EsgCode": "EXEC",
      "EsgName": "Executive Payroll",
      "EsgIuCreateDate": "2015-05-11T13:13:22Z",
      "EsgIuCreateUser": "ADWAIT",
      "EsgIuUpdateDate": null,
      "EsgIuUpdateUser": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsecgrp/EXEC",
          "name": "pyempsecgrp",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsecgrp/EXEC",
          "name": "pyempsecgrp",
          "kind": "item"
        }
      ]
    },
    {
      "EsgCode": "NONE",
      "EsgName": "NONE",
      "EsgIuCreateDate": "2019-05-08T19:49:10Z",
      "EsgIuCreateUser": "CANDICE",
      "EsgIuUpdateDate": null,
      "EsgIuUpdateUser": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsecgrp/NONE",
          "name": "pyempsecgrp",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsecgrp/NONE",
          "name": "pyempsecgrp",
          "kind": "item"
        }
      ]
    },
    {
      "EsgCode": "TEST",
      "EsgName": "Test",
      "EsgIuCreateDate": "2023-04-04T16:26:24Z",
      "EsgIuCreateUser": "AGAVE",
      "EsgIuUpdateDate": null,
      "EsgIuUpdateUser": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsecgrp/TEST",
          "name": "pyempsecgrp",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsecgrp/TEST",
          "name": "pyempsecgrp",
          "kind": "item"
        }
      ]
    },
    {
      "EsgCode": "WORK",
      "EsgName": "Workato Group",
      "EsgIuCreateDate": "2022-11-02T22:32:22Z",
      "EsgIuCreateUser": "WORKATO",
      "EsgIuUpdateDate": null,
      "EsgIuUpdateUser": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsecgrp/WORK",
          "name": "pyempsecgrp",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsecgrp/WORK",
          "name": "pyempsecgrp",
          "kind": "item"
        }
      ]
    }
  ],
  "count": 5,
  "hasMore": false,
  "limit": 5,
  "offset": 0,
  "links": [
    {
      "rel": "self",
      "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/hcm-rest-api/rest/1/pyempsecgrp",
      "name": "pyempsecgrp",
      "kind": "collection"
    }
  ]
}
```

object