---
title: "Retrieve Region Lists By Code"
slug: "retrieve-region-lists-by-code"
updated: 2026-05-26T12:48:31Z
published: 2026-05-26T12:48:45Z
canonical: "developers.cmicglobal.com/retrieve-region-lists-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 Region Lists By Code

Get/sys-rest-api/rest/1/gtregion

## Query Standards

### Finder

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

- Select by Reg Name
- Select by Reg Code
- By UUID

## Select by Region Name

Recommended finder parameters. Refer to Query Parameters for example.

#### Parameters

| Parameter | Description | Sample |
| --- | --- | --- |
| regName | Name of the region | California |

## Select by Region Code

This is an optional finder for querying Regions by their Code.

#### Parameters

| Parameter | Description | Sample |
| --- | --- | --- |
| regCode | Code of the region | AL |

#### By UUID

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

| Parameter | Description | Sample |
| --- | --- | --- |
| /VUUID | The VUuid attribute is the Unique row ID | placeholder |

SecurityHTTPType basic

Basic authentication

Query parametersfinderstringExampleselectByRegCode; regionCode=AL
limitintegerExample500
offsetintegerExample0
totalResultsbooleanExampletrue
orderBystringExampleorderBy=RegCode:desc

Responses200

OK

HeadersContent-TypestringExampleapplication/vnd.oracle.adf.resourcecollection+json
<select class='api-response-data' aria-label='Media type'><option value='6552a68a-8d09-4ecc-8429-f6b0b226fa70'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='3e508ff2-36d8-4e26-aec4-5918cd892e14'>example-0</option>
<option value='1d2d311e-65ea-4ff5-8dfa-0043e0850f56'>example-1</option>
</select>example-0

Successful Response - Finder - selectByRegName

```json
{
  "items": [
    {
      "RegCode": "CA",
      "RegName": "California",
      "RegComplianceCode": null,
      "RegVUuid": "D0A47915ECFC5D7AE05316821FAC6D84",
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/sys-rest-api/rest/1/gtregion/D0A47915ECFC5D7AE05316821FAC6D84",
          "name": "gtregion",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/sys-rest-api/rest/1/gtregion/D0A47915ECFC5D7AE05316821FAC6D84",
          "name": "gtregion",
          "kind": "item"
        }
      ]
    }
  ],
  "count": 1,
  "hasMore": false,
  "limit": 5,
  "offset": 0,
  "links": [
    {
      "rel": "self",
      "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/sys-rest-api/rest/1/gtregion",
      "name": "gtregion",
      "kind": "collection"
    }
  ]
}
```

example-1

Successful Response - Finder - selectByRegCode

```json
{
  "items": [
    {
      "RegCode": "AL",
      "RegName": "Alabama",
      "RegComplianceCode": null,
      "RegVUuid": "D0A47915ECF85D7AE05316821FAC6D84",
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/sys-rest-api/rest/1/gtregion/D0A47915ECF85D7AE05316821FAC6D84",
          "name": "gtregion",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/sys-rest-api/rest/1/gtregion/D0A47915ECF85D7AE05316821FAC6D84",
          "name": "gtregion",
          "kind": "item"
        }
      ]
    }
  ],
  "count": 1,
  "hasMore": false,
  "limit": 5,
  "offset": 0,
  "links": [
    {
      "rel": "self",
      "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/sys-rest-api/rest/1/gtregion",
      "name": "gtregion",
      "kind": "collection"
    }
  ]
}
```

object