> ## 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 > ## 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 | ## OpenAPI ````json GET /em-rest-api/rest/1/emactloc { "openapi": "3.0.0", "info": { "title": "API Catalog", "description": "", "version": "1.0.0" }, "servers": [ { "url": "https://mobtest.cmiccloudr12.com/cmictestrti", "description": "CMIC API Server" } ], "security": [ { "cmicBasicAuth": [] } ], "tags": [ { "name": "Highlights" }, { "name": "Asset Management | Equipment" }, { "name": "Asset Management | Fixed Assets" }, { "name": "Asset Management | Purchase Order" }, { "name": "Asset Management | Inventory" }, { "name": "Asset Management | Requisition" }, { "name": "Bim Model" }, { "name": "Bim Model Revision" }, { "name": "Bim Tag Model" }, { "name": "Bim Tags" }, { "name": "Bim FileUpload Jersey" }, { "name": "Core System | Business Partners" }, { "name": "Core System | Business Partner Addresses" }, { "name": "Core System | Bank" }, { "name": "Core System | Currency" }, { "name": "Core System | Exchange Rates" }, { "name": "Core System | Global Table Text Codes" }, { "name": "Core System | Global Table Regions" }, { "name": "Core System | Terms" }, { "name": "Core System | System Contact" }, { "name": "Core System | Weight Measures" }, { "name": "Core System | Field User Defined Classifiers" }, { "name": "Core System | User Defined Classifiers by Object" }, { "name": "Core System | User Extension Definitions by Object" }, { "name": "Core System | User Extention Field Data Value" }, { "name": "Core System | User Extension Values by Object" }, { "name": "Core System | User System Role" }, { "name": "Core System | User Project Role" }, { "name": "Core System | Documents by Object" }, { "name": "Core System | Audit Status Log by Object" }, { "name": "Core System | Licensed Users" }, { "name": "Core System | Company Access" }, { "name": "Core System | Copy User Settings" }, { "name": "Core System | User Maintenance" }, { "name": "Core System | User Roles" }, { "name": "Core System | Security Groups" }, { "name": "Core System | Job/Project Security" }, { "name": "ECM and Workflow | Image Manager" }, { "name": "Financials | General Ledger" }, { "name": "Financials | Accounts Payable" }, { "name": "Financials | Accounts Receivable" }, { "name": "Preventative Maintenance | Issue Work Orders" }, { "name": "Preventative Maintenance | Issue Work Items" }, { "name": "Preventative Maintenance | Issue Work Budgets" }, { "name": "Preventative Maintenance | Issue Priorities" }, { "name": "Preventative Maintenance | Issue Status" }, { "name": "Preventative Maintenance | Issue Types" }, { "name": "Preventative Maintenance | Accumulative Equipment" }, { "name": "Preventative Maintenance | Work Orders" }, { "name": "Preventative Maintenance | Work Items" }, { "name": "Preventative Maintenance | Work Budgets" }, { "name": "Preventative Maintenance | Priorities" }, { "name": "Preventative Maintenance | Tasks" }, { "name": "HCM | UKG Pay Deductions" }, { "name": "HCM | UKG Pay Earnings" }, { "name": "HCM | UKG Pay Headers" }, { "name": "HCM | UKG Pay Taxes" }, { "name": "HCM | Payroll Geographical States" }, { "name": "HCM | Payroll Trades" }, { "name": "HCM | Payroll Union" }, { "name": "HCM | Payroll Pay Runs" }, { "name": "HCM | Payroll Pay Groups" }, { "name": "HCM | Payroll Tax" }, { "name": "HCM | Payroll Worker Compensation" }, { "name": "HCM | Payroll Work Locations" }, { "name": "HCM | Payroll Trade Pay Rates" }, { "name": "HCM | Payroll Union Pay Rates" }, { "name": "HCM | Payroll Job Pay Rates" }, { "name": "HCM | Payroll Master Benefits" }, { "name": "HCM | Payroll Master Deductions" }, { "name": "HCM | Payroll Ben/Ded/Leave Base Codes" }, { "name": "HCM | Payroll Ben/Ded Plans" }, { "name": "HCM | Payroll Ben/Ded Plan Options" }, { "name": "HCM | Payroll Company Benefits" }, { "name": "HCM | Payroll Company Deductions" }, { "name": "HCM | Payroll Vertex Geographic Locations" }, { "name": "HCM | Payroll Checks" }, { "name": "HCM | Payroll Timesheets" }, { "name": "HCM | Employee" }, { "name": "HCM | Employee (Minimum payload)" }, { "name": "HCM | Employee History" }, { "name": "HCM | Tax Exemptions" }, { "name": "HCM | Employee Tax Overrides" }, { "name": "HCM | Employee Pay Splits" }, { "name": "HCM | Employee Benefits" }, { "name": "HCM | Employee Clock In and Out" }, { "name": "HCM | Employee Deductions" }, { "name": "HCM | Employee Leaves" }, { "name": "HCM | Employee Leave History" }, { "name": "HCM | Employee Hour Types" }, { "name": "HCM | Employee Pay History" }, { "name": "HCM | Employee Work Statuses" }, { "name": "HCM | Employee Security Group" }, { "name": "HCM | Crewtime Crew" }, { "name": "HCM | Crewtime Employee Timesheet" }, { "name": "HCM | Crewtime Equipment Timesheet" }, { "name": "HCM | Crew Maintenance Activity Assignment" }, { "name": "HCM | Crew Maintenance Member Assignment" }, { "name": "HCM | Crew Maintenance Member Trade and Union Assignment" }, { "name": "HCM | Crew Maintenance Equipment Assignment" }, { "name": "HCM | Crew Maintenance Equipment Detail Assignment" }, { "name": "HCM | HR Requisitions" }, { "name": "HCM | HR Relations" }, { "name": "HCM | HR Employee Skills" }, { "name": "HCM | HR Incident" }, { "name": "HCM | HR Employee Relatives / Dependents" }, { "name": "HCM | HR Employee Positions" }, { "name": "HCM | HR Applicants" }, { "name": "HCM | HR Applications" }, { "name": "HCM | Vertex Location City" }, { "name": "HCM | HR Application History" }, { "name": "HCM | HR Dependent Benefits" }, { "name": "HCM | HR Dependent Deductions" }, { "name": "HCM | HR Employee Elected Plans" }, { "name": "HCM | HR Employee Training Certifications" }, { "name": "HCM | HR Trainings" }, { "name": "HCM | E-Timesheets" }, { "name": "HCM | System Contacts" }, { "name": "HCM | System User Payroll Security Group" }, { "name": "HCM | Payroll Timesheet Posting" }, { "name": "HCM | CrewTimesheet Posting" }, { "name": "Materials Management | Material Sale Orders" }, { "name": "Materials Management | Material Sale Orders Details" }, { "name": "Materials Management | Truck Rate Detail" }, { "name": "Opportunity Management | Competitors" }, { "name": "Opportunity Management | Opportunities" }, { "name": "Opportunity Management | Revenue Details" }, { "name": "Opportunity Management | Opportunity History" }, { "name": "Opportunity Management | Organization" }, { "name": "Project Controls | Job Billing" }, { "name": "Project Controls | Job Cost" }, { "name": "Project Controls | PCI Details" }, { "name": "Project Controls | Unposted PCI Details" }, { "name": "Project Controls | PCI Headers" }, { "name": "Project Controls | Owner Change Orders" }, { "name": "Project Controls | RFQ (Request for Quote) Extensions" }, { "name": "Project Controls | CM Statuses" }, { "name": "Project Controls | CM Types" }, { "name": "Project Controls | CM Vendor Details" }, { "name": "Project Controls | Post PCI" }, { "name": "Project Management | Uploading Documents" }, { "name": "Project Management | Downloading Documents" }, { "name": "Project Management | Foreign Bid Item Imports" }, { "name": "Project Management | Communications" }, { "name": "Project Management | Daily Journals" }, { "name": "Project Management | Communications Types" }, { "name": "Project Management | Daily Journal Daily Work Plans" }, { "name": "Project Management | Daily Journal Field Forces" }, { "name": "Project Management | Daily Journal Labour" }, { "name": "Project Management | Daily Journal Materials" }, { "name": "Project Management | Daily Journal Owner Equipment" }, { "name": "Project Management | Daily Journal Quality Control" }, { "name": "Project Management | Daily Journal Tasks" }, { "name": "Project Management | Daily Journal Trade Equipment" }, { "name": "Project Management | Daily Journal Transactions" }, { "name": "Project Management | Daily Journal User Defined Data" }, { "name": "Project Management | Daily Journal Visitors" }, { "name": "Project Management | Daily Journal Bill Details" }, { "name": "Project Management | Field Work Directives" }, { "name": "Project Management | Contract Types" }, { "name": "Project Management | Company Contacts" }, { "name": "Project Management | Distribution BCC" }, { "name": "Project Management | Distribution CC" }, { "name": "Project Management | Field Work Directive Statuses" }, { "name": "Project Management | Issues" }, { "name": "Project Management | Key Players" }, { "name": "Project Management | Meetings" }, { "name": "Project Management | Meeting Attendees" }, { "name": "Project Management | Meeting Item Statuses" }, { "name": "Project Management | Meeting Tracks" }, { "name": "Project Management | Notes" }, { "name": "Project Management | Projects" }, { "name": "Project Management | Project Items" }, { "name": "Project Management | Project Item Phase Segment Sums" }, { "name": "Project Management | Project Partners" }, { "name": "Project Management | Notices" }, { "name": "Project Management | Notice Statuses" }, { "name": "Project Management | Owner JS Query" }, { "name": "Project Management | PCI Real Locations" }, { "name": "Project Management | Project Contacts" }, { "name": "Project Management | RFIs (Requests for Information)" }, { "name": "Project Management | RFI Statuses" }, { "name": "Project Management | Submittal Packages" }, { "name": "Project Management | Submittal Package Details" }, { "name": "Project Management | Submittal Package Status" }, { "name": "Project Management | Submittals" }, { "name": "Project Management | Submittal Status" }, { "name": "Project Management | Transmittals" }, { "name": "Project Management | Subcontract Headers" }, { "name": "Project Management | Subcontract Schedules" }, { "name": "Project Management | Subcontract Sechedule Phase Segment Sums" }, { "name": "Project Management | User Roles" }, { "name": "Project Management | Punchlists" }, { "name": "Project Management | Punchlist Details" }, { "name": "Project Management | Punchlist Statuses" }, { "name": "Project Management | Meeting Items" }, { "name": "Project Management | Self Perform Vendor" }, { "name": "Project Management | Submittal Types" }, { "name": "Project Management | Assign contact and partner to project" }, { "name": "Project Management | Subcontract Prequal" }, { "name": "Project Management | Bid Item Package" } ], "paths": { "/em-rest-api/rest/1/emactloc": { "get": { "tags": [ "Asset Management | Equipment" ], "summary": "Retrieve Equipment Actual Locations By Code", "description": "## Query Standards\n\n### Finder\n\nFollowing row finders are available for data filtering and optimizing request performance.\n\n- Find by Code\n- Find by Date\n- By UUID\n \n\n#### Select by Code\n\nRecommended finder parameters. Refer to Query Parameters for example.\n\n| Parameter | Description | Sample |\n| --- | --- | --- |\n| locationCode | Location code | 001-CHI |\n\n#### Select by Date\n\nThis is an optional finder for querying Equipment Actual Locations by Audit Date.\n\n| Parameter | Description | Sample |\n| --- | --- | --- |\n| AuditDate | Create or update date time filter | 2022-12-20 |\n\n#### By UUID\n\nThis is an optional finder for querying a specific Equipment Actual Location by row ID.\n\n| Parameter | Description | Sample |\n| --- | --- | --- |\n| /VUUID | The VUuid attribute is the Unique row ID | /em-rest-api/rest/1/emactloc/001-CHI |", "parameters": [ { "name": "finder", "in": "query", "schema": { "type": "string" }, "example": "findByCode; locationCode=001-CHI" }, { "name": "limit", "in": "query", "schema": { "type": "integer" }, "example": "500" }, { "name": "offset", "in": "query", "schema": { "type": "integer" }, "example": "0" }, { "name": "totalResults", "in": "query", "schema": { "type": "boolean" }, "example": "true" }, { "name": "orderBy", "in": "query", "schema": { "type": "string" }, "example": "EmalActuallocCode:desc" } ], "responses": { "200": { "description": "OK", "headers": { "Content-Type": { "schema": { "type": "string", "example": "application/vnd.oracle.adf.resourcecollection+json" } } }, "content": { "application/json": { "schema": { "type": "object" }, "examples": { "example-0": { "summary": "Successful Response - Finder - findByDate", "value": { "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:27+00:00", "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:20+00:00", "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": "05-2016", "EmalName": "33 Wells Road", "EmalSname": null, "EmalDefaultCompCode": "001", "EmalDefaultCompName": "CMiC Construction Inc", "EmalDefaultJobCode": "05-2016", "EmalDefaultJobName": "32 Wells Street", "EmalDefaultPhsCode": null, "EmalDefaultPhsName": null, "EmalDefaultCatCode": null, "EmalDefaultCatName": null, "EmalDefaultCustCode": "11-0588", "EmalDefaultCustName": "Minto Group Ltd", "EmalStatusFlag": "Y", "EmalRetireFlag": "N", "EmalExcldTargetUtilCalc": "N", "EmalIuCreateDate": "2016-08-18T13:06:56+00:00", "EmalIuUpdateDate": "2016-10-27T14:47:31+00:00", "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": "11-0588", "EmalDefaultCustName": "Minto Group Ltd", "EmalStatusFlag": "Y", "EmalRetireFlag": "N", "EmalExcldTargetUtilCalc": "N", "EmalIuCreateDate": "2016-10-26T17:36:41+00:00", "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:41+00:00", "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": { "summary": "Successful Response - Finder - findByCode", "value": { "items": [ { "EmalActuallocCode": "001-CHI", "EmalName": "Chicago Yard / Warehouse", "EmalSname": null, "EmalDefaultCompCode": "001", "EmalDefaultCompName": "CMiC Construction Inc", "EmalDefaultJobCode": "05-2016", "EmalDefaultJobName": "32 Wells Street", "EmalDefaultPhsCode": "00750", "EmalDefaultPhsName": "Permits", "EmalDefaultCatCode": "O", "EmalDefaultCatName": "Other", "EmalDefaultCustCode": "11-0588", "EmalDefaultCustName": "Minto Group Ltd", "EmalStatusFlag": "Y", "EmalRetireFlag": "N", "EmalExcldTargetUtilCalc": "N", "EmalIuCreateDate": "2023-08-18T14:29:34+00:00", "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" } ] } } } } } } } } } }, "components": { "securitySchemes": { "cmicBasicAuth": { "type": "http", "scheme": "basic", "description": "Basic authentication" } } } } ````