Retrieve Region Lists By Code
  • 13 Jun 2025
  • 1 Minute to read
  • Dark
    Light

Retrieve Region Lists By Code

  • Dark
    Light

Article summary

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

ParameterDescriptionSample
regNameName of the regionCalifornia

Select by Region Code

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

Parameters

ParameterDescriptionSample
regCodeCode of the regionAL

By UUID

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

ParameterDescriptionSample
/VUUIDThe VUuid attribute is the Unique row IDplaceholder
Security
HTTP
Type basic

Basic authentication

Query parameters
finder
string
ExampleselectByRegCode; regionCode=AL
limit
integer
Example500
offset
integer
Example0
totalResults
boolean
Exampletrue
orderBy
string
ExampleorderBy=RegCode:desc
Responses
200

OK

Headers
Content-Type
string
Exampleapplication/vnd.oracle.adf.resourcecollection+json
example-0

Successful Response - Finder - selectByRegName

{
  "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

{
  "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