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

Get/em-rest-api/rest/1/emhomeloc

## 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 Equipment Home 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 Home Location by row ID.

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

SecurityHTTPType basic

Basic authentication

Query parametersfinderstringExamplefindByCode;locationCode=001-SF
limitintegerExample500
offsetintegerExample0
totalResultsbooleanExampletrue
orderBystringExampleEmhlHomelocCode:desc

Responses200

OK

HeadersContent-TypestringExampleapplication/vnd.oracle.adf.resourcecollection+json
<select class='api-response-data' aria-label='Media type'><option value='c5ef736f-38e5-4a2f-9472-bce24915bfe2'>application/json</option>
</select><select class='select-example' aria-label='Media type'><option value='aef6ee55-3153-40cf-9fdd-02ac7ca050d9'>example-0</option>
<option value='807420b6-4217-44b2-86f6-456a70f3f6d7'>example-1</option>
</select>example-0

Successful Response - Finder - findByDate

```json
{
  "items": [
    {
      "EmhlHomelocCode": "001-CHI",
      "EmhlName": "Chicago Yard / Warehouse",
      "EmhlSname": null,
      "EmhlCompCode": "001",
      "EmhlCompName": "CMiC Construction Inc",
      "EmhlDeptCode": "416",
      "EmhlDeptName": "Chicago Equip / Whse",
      "EmhlIuCreateDate": "2015-05-11T15:03:28Z",
      "EmhlIuUpdateDate": null,
      "EmhlErecIncFlag": "N",
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-CHI",
          "name": "emhomeloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-CHI",
          "name": "emhomeloc",
          "kind": "item"
        }
      ]
    },
    {
      "EmhlHomelocCode": "001-SF",
      "EmhlName": "San Francisco Yard / Warehouse",
      "EmhlSname": null,
      "EmhlCompCode": "001",
      "EmhlCompName": "CMiC Construction Inc",
      "EmhlDeptCode": "716",
      "EmhlDeptName": "San Francisco Equip / Whse",
      "EmhlIuCreateDate": "2015-05-11T15:03:28Z",
      "EmhlIuUpdateDate": null,
      "EmhlErecIncFlag": "N",
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-SF",
          "name": "emhomeloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-SF",
          "name": "emhomeloc",
          "kind": "item"
        }
      ]
    },
    {
      "EmhlHomelocCode": "001-EXT",
      "EmhlName": "External Customers",
      "EmhlSname": null,
      "EmhlCompCode": "001",
      "EmhlCompName": "CMiC Construction Inc",
      "EmhlDeptCode": "080",
      "EmhlDeptName": "Support Services",
      "EmhlIuCreateDate": "2015-05-11T15:03:28Z",
      "EmhlIuUpdateDate": null,
      "EmhlErecIncFlag": "N",
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-EXT",
          "name": "emhomeloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-EXT",
          "name": "emhomeloc",
          "kind": "item"
        }
      ]
    },
    {
      "EmhlHomelocCode": "HIKUU- YRD",
      "EmhlName": "Company HIKUU Yard / Warehouse",
      "EmhlSname": null,
      "EmhlCompCode": "HIKUU",
      "EmhlCompName": "CMiC Construction Canada Ltd.",
      "EmhlDeptCode": "056",
      "EmhlDeptName": "Equipment/Warehouse Operations",
      "EmhlIuCreateDate": "2015-05-11T15:03:28Z",
      "EmhlIuUpdateDate": null,
      "EmhlErecIncFlag": "N",
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/HIKUU-%20YRD",
          "name": "emhomeloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/HIKUU-%20YRD",
          "name": "emhomeloc",
          "kind": "item"
        }
      ]
    },
    {
      "EmhlHomelocCode": "002-YARD",
      "EmhlName": "Company 002 Yard / Warehouse",
      "EmhlSname": null,
      "EmhlCompCode": "002",
      "EmhlCompName": "Fresenius Medical Care",
      "EmhlDeptCode": "056",
      "EmhlDeptName": "Equipment/Warehouse Operations",
      "EmhlIuCreateDate": "2015-05-11T15:03:28Z",
      "EmhlIuUpdateDate": null,
      "EmhlErecIncFlag": "N",
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/002-YARD",
          "name": "emhomeloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/002-YARD",
          "name": "emhomeloc",
          "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/emhomeloc",
      "name": "emhomeloc",
      "kind": "collection"
    }
  ]
}
```

example-1

Successful Response - Finder - findByCode

```json
{
  "items": [
    {
      "EmhlHomelocCode": "001-SF",
      "EmhlName": "San Francisco Yard / Warehouse",
      "EmhlSname": null,
      "EmhlCompCode": "001",
      "EmhlCompName": "CMiC Construction Inc",
      "EmhlDeptCode": "716",
      "EmhlDeptName": "San Francisco Equip / Whse",
      "EmhlIuCreateDate": "2015-05-11T15:03:28Z",
      "EmhlIuUpdateDate": null,
      "EmhlErecIncFlag": "N",
      "links": [
        {
          "rel": "self",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-SF",
          "name": "emhomeloc",
          "kind": "item"
        },
        {
          "rel": "canonical",
          "href": "http://mobtest.cmiccloudr12.com:80/cmictestrti/em-rest-api/rest/1/emhomeloc/001-SF",
          "name": "emhomeloc",
          "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/emhomeloc",
      "name": "emhomeloc",
      "kind": "collection"
    }
  ]
}
```

object