---
title: "Retrieve Equipment Actual Locations By Code"
slug: "retrieve-equipment-actual-locations-by-code"
updated: 2026-05-26T12:53:14Z
published: 2026-05-26T12:53:48Z
canonical: "developers.cmicglobal.com/retrieve-equipment-actual-locations-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 Equipment Actual Locations By Code

Get/em-rest-api/rest/1/emactloc

## Query Standards

### Finder

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

- Find by Code
- Find by Date
- By UUID

#### Select by Code

Recommended finder parameters. Refer to Query Parameters for example.

| Parameter | Description | Sample |
| --- | --- | --- |
| locationCode | Location code | 001-CHI |

#### Select by Date

This is an optional finder for querying Equipment Actual Locations by Audit Date.

| Parameter | Description | Sample |
| --- | --- | --- |
| AuditDate | Create or update date time filter | 2022-12-20 |

#### By UUID

This is an optional finder for querying a specific Equipment Actual Location by row ID.

| Parameter | Description | Sample |
| --- | --- | --- |
| /VUUID | The VUuid attribute is the Unique row ID | /em-rest-api/rest/1/emactloc/001-CHI |

SecurityHTTPType basic

Basic authentication

Query parametersfinderstringExamplefindByCode; locationCode=001-CHI
limitintegerExample500
offsetintegerExample0
totalResultsbooleanExampletrue
orderBystringExampleEmalActuallocCode:desc

Responses200

OK

HeadersContent-TypestringExampleapplication/vnd.oracle.adf.resourcecollection+json
<select class='api-response-data' aria-label='Media type'><option value='3f1e9f43-eed8-4997-b30b-aa67c5a303d4'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='eaf0f317-b744-461c-bddc-ec122d1fe3df'>example-0</option>
<option value='e558ff76-671d-4f17-b024-868a18abb77a'>example-1</option>
</select>example-0

Successful Response - Finder - findByDate

```json
{
  "items": [
    {
      "EmalActuallocCode": "032017",
      "EmalName": "HWY 47",
      "EmalSname": null,
      "EmalDefaultCompCode": "HIKUU",
      "EmalDefaultCompName": "CMiC Construction Canada Ltd.",
      "EmalDefaultJobCode": "032017",
      "EmalDefaultJobName": null,
      "EmalDefaultPhsCode": null,
      "EmalDefaultPhsName": null,
      "EmalDefaultCatCode": null,
      "EmalDefaultCatName": null,
      "EmalDefaultCustCode": "CITYOFED",
      "EmalDefaultCustName": "City of Edmonton",
      "EmalStatusFlag": "Y",
      "EmalRetireFlag": "N",
      "EmalExcldTargetUtilCalc": "N",
      "EmalIuCreateDate": "2017-02-06T16:31:27Z",
      "EmalIuUpdateDate": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/032017",
          "name": "emactloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/032017",
          "name": "emactloc",
          "kind": "item"
        }
      ]
    },
    {
      "EmalActuallocCode": "042016",
      "EmalName": "HWY 407",
      "EmalSname": null,
      "EmalDefaultCompCode": "001",
      "EmalDefaultCompName": "CMiC Construction Inc",
      "EmalDefaultJobCode": "042016",
      "EmalDefaultJobName": "CMiC Cloud Prod (July)",
      "EmalDefaultPhsCode": null,
      "EmalDefaultPhsName": null,
      "EmalDefaultCatCode": null,
      "EmalDefaultCatName": null,
      "EmalDefaultCustCode": "46001",
      "EmalDefaultCustName": "City of La Verne",
      "EmalStatusFlag": "Y",
      "EmalRetireFlag": "N",
      "EmalExcldTargetUtilCalc": "N",
      "EmalIuCreateDate": "2016-10-27T14:47:20Z",
      "EmalIuUpdateDate": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/042016",
          "name": "emactloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/042016",
          "name": "emactloc",
          "kind": "item"
        }
      ]
    },
    {
      "EmalActuallocCode": "2016-05-01T00:00:00Z",
      "EmalName": "33 Wells Road",
      "EmalSname": null,
      "EmalDefaultCompCode": "001",
      "EmalDefaultCompName": "CMiC Construction Inc",
      "EmalDefaultJobCode": "2016-05-01T00:00:00Z",
      "EmalDefaultJobName": "32 Wells Street",
      "EmalDefaultPhsCode": null,
      "EmalDefaultPhsName": null,
      "EmalDefaultCatCode": null,
      "EmalDefaultCatName": null,
      "EmalDefaultCustCode": "0588-11-01T00:00:00Z",
      "EmalDefaultCustName": "Minto Group Ltd",
      "EmalStatusFlag": "Y",
      "EmalRetireFlag": "N",
      "EmalExcldTargetUtilCalc": "N",
      "EmalIuCreateDate": "2016-08-18T13:06:56Z",
      "EmalIuUpdateDate": "2016-10-27T14:47:31Z",
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/05-2016",
          "name": "emactloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/05-2016",
          "name": "emactloc",
          "kind": "item"
        }
      ]
    },
    {
      "EmalActuallocCode": "051188",
      "EmalName": "58 Bankers Hill",
      "EmalSname": null,
      "EmalDefaultCompCode": "001",
      "EmalDefaultCompName": "CMiC Construction Inc",
      "EmalDefaultJobCode": "051188",
      "EmalDefaultJobName": "58 Bankers Hill Renovations",
      "EmalDefaultPhsCode": null,
      "EmalDefaultPhsName": null,
      "EmalDefaultCatCode": null,
      "EmalDefaultCatName": null,
      "EmalDefaultCustCode": "0588-11-01T00:00:00Z",
      "EmalDefaultCustName": "Minto Group Ltd",
      "EmalStatusFlag": "Y",
      "EmalRetireFlag": "N",
      "EmalExcldTargetUtilCalc": "N",
      "EmalIuCreateDate": "2016-10-26T17:36:41Z",
      "EmalIuUpdateDate": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/051188",
          "name": "emactloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/051188",
          "name": "emactloc",
          "kind": "item"
        }
      ]
    },
    {
      "EmalActuallocCode": "072016",
      "EmalName": "Hilton Hotel",
      "EmalSname": null,
      "EmalDefaultCompCode": "002",
      "EmalDefaultCompName": "Fresenius Medical Care",
      "EmalDefaultJobCode": "072016",
      "EmalDefaultJobName": null,
      "EmalDefaultPhsCode": null,
      "EmalDefaultPhsName": null,
      "EmalDefaultCatCode": null,
      "EmalDefaultCatName": null,
      "EmalDefaultCustCode": "HHO001",
      "EmalDefaultCustName": "Hilton Hotels Inc.",
      "EmalStatusFlag": "Y",
      "EmalRetireFlag": "N",
      "EmalExcldTargetUtilCalc": "N",
      "EmalIuCreateDate": "2016-10-26T17:36:41Z",
      "EmalIuUpdateDate": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/072016",
          "name": "emactloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/072016",
          "name": "emactloc",
          "kind": "item"
        }
      ]
    }
  ],
  "count": 5,
  "hasMore": true,
  "limit": 5,
  "offset": 0,
  "links": [
    {
      "rel": "self",
      "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc",
      "name": "emactloc",
      "kind": "collection"
    }
  ]
}
```

example-1

Successful Response - Finder - findByCode

```json
{
  "items": [
    {
      "EmalActuallocCode": "001-CHI",
      "EmalName": "Chicago Yard / Warehouse",
      "EmalSname": null,
      "EmalDefaultCompCode": "001",
      "EmalDefaultCompName": "CMiC Construction Inc",
      "EmalDefaultJobCode": "2016-05-01T00:00:00Z",
      "EmalDefaultJobName": "32 Wells Street",
      "EmalDefaultPhsCode": "00750",
      "EmalDefaultPhsName": "Permits",
      "EmalDefaultCatCode": "O",
      "EmalDefaultCatName": "Other",
      "EmalDefaultCustCode": "0588-11-01T00:00:00Z",
      "EmalDefaultCustName": "Minto Group Ltd",
      "EmalStatusFlag": "Y",
      "EmalRetireFlag": "N",
      "EmalExcldTargetUtilCalc": "N",
      "EmalIuCreateDate": "2023-08-18T14:29:34Z",
      "EmalIuUpdateDate": null,
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/001-CHI",
          "name": "emactloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc/001-CHI",
          "name": "emactloc",
          "kind": "item"
        }
      ]
    }
  ],
  "count": 1,
  "hasMore": false,
  "limit": 5,
  "offset": 0,
  "links": [
    {
      "rel": "self",
      "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emactloc",
      "name": "emactloc",
      "kind": "collection"
    }
  ]
}
```

object