Get location information
post
/bi/v1/{orgIdentifier}/getLocationDimensions
Gets the location information for all or a specified location.
Request
Path Parameters
-
orgIdentifier: string
Unique identifier of the organization name
The request body defines the details of the API request.
Root Schema : locDimRequestPayload
Type:
object
Request payload for location dimensions
Show Source
-
applicationName(optional):
string
Title:
Application Name
Maximum Length:128
The name of the application which is accessing the API.First Available Version: 20.1.10
-
include(optional):
string
Title:
Include
List of objects to include in response -
locRef(optional):
string
Title:
Location Reference
The location reference, this may be a store number or name depending on the organization -
searchCriteria(optional):
string
Title:
Search Criteria
Search criteria to filter results based on field value
Response
Supported Media Types
- application/json
200 Response
OK
Root Schema : locationDimensions
Type:
Show Source
object
-
locations:
array locations
An array of Location Dimensions
Nested Schema : locations
Type:
array
An array of Location Dimensions
Show Source
-
Array of:
object location
The response body contains information about a specified location.
Nested Schema : location
Type:
object
The response body contains information about a specified location.
Show Source
-
active:
boolean
Title:
Active
Flag indicating if this location is active or not -
curr:
string
Title:
Currency
Maximum Length:3
Abbreviation of the currency configured at the location. This attribute will not be returned in the response if value is null -
locRef:
string
Title:
Location Reference
Maximum Length:99
The location reference, this may be a store number or name depending on the organization -
name:
string
Title:
Name
Maximum Length:99
Name of the location -
openDt:
string(date)
Title:
Open Date
The date this location was opened -
srcName:
string
Title:
Source Name
Maximum Length:99
The name of the POS system associated with this location -
srcVer:
string
Title:
Source Version
Maximum Length:99
The POS version associated with this location -
tz:
string
Title:
Time Zone
Maximum Length:99
Time zone configured at the location -
workstations:
array Workstations
Title:
Workstations
An array of workstations. This attribute will not be returned in the response if there are no workstations associated
Nested Schema : Workstations
Type:
array
Title:
Workstations
An array of workstations. This attribute will not be returned in the response if there are no workstations associated
Show Source
-
Array of:
object workStation
The response body contains information about a workstation for the specified location.
Nested Schema : workStation
Type:
object
The response body contains information about a workstation for the specified location.
Show Source
-
wsName:
string
Title:
Workstation Name
Maximum Length:99
Workstation Name. This attribute will not be returned in the response if value is null -
wsNum:
integer
Title:
Workstation Number
Maximum Length:16
Workstation number
400 Response
Bad Request
Root Schema : exceptionDetailType
Type:
object
Error details
Show Source
-
detail(optional):
string
Title:
Error description
The description of the error -
o:errorCode:
integer
Title:
Oracle error code
Oracle error code -
status(optional):
integer
Title:
Status
HTTP response code -
title:
string
Title:
Title
High level description of the error -
type:
string
Title:
Type
The description of the type of HTTP error
401 Response
Unauthorized
Root Schema : exceptionDetailType
Type:
object
Error details
Show Source
-
detail(optional):
string
Title:
Error description
The description of the error -
o:errorCode:
integer
Title:
Oracle error code
Oracle error code -
status(optional):
integer
Title:
Status
HTTP response code -
title:
string
Title:
Title
High level description of the error -
type:
string
Title:
Type
The description of the type of HTTP error
403 Response
Service Unavailable
Root Schema : exceptionDetailType
Type:
object
Error details
Show Source
-
detail(optional):
string
Title:
Error description
The description of the error -
o:errorCode:
integer
Title:
Oracle error code
Oracle error code -
status(optional):
integer
Title:
Status
HTTP response code -
title:
string
Title:
Title
High level description of the error -
type:
string
Title:
Type
The description of the type of HTTP error
404 Response
Resource Not Found
Root Schema : exceptionDetailType
Type:
object
Error details
Show Source
-
detail(optional):
string
Title:
Error description
The description of the error -
o:errorCode:
integer
Title:
Oracle error code
Oracle error code -
status(optional):
integer
Title:
Status
HTTP response code -
title:
string
Title:
Title
High level description of the error -
type:
string
Title:
Type
The description of the type of HTTP error
Default Response
Unexpected Error
Root Schema : exceptionDetailType
Type:
object
Error details
Show Source
-
detail(optional):
string
Title:
Error description
The description of the error -
o:errorCode:
integer
Title:
Oracle error code
Oracle error code -
status(optional):
integer
Title:
Status
HTTP response code -
title:
string
Title:
Title
High level description of the error -
type:
string
Title:
Type
The description of the type of HTTP error
Examples
The following example shows how to get the location dimensions for a specified location by submitting a POST request on the REST resource using cURL. For more information, see Use cURL
curl -i -X POST -H "Authorization: Bearer" -H "Content-Type:application/json" -d {"locRef":"1234"} https://baseurl/bi/v1/orgidentifier/getLocationDimensions
Example of Response Header
The following shows an example of the response header.
HTTP/1.1 200 OK Date: Tue, 20 Oct 2020 21:24:33 GMT Transfer-Encoding: chunked Content-Type: application/json
Example of Response Body
The following example shows the contents of the response body in JSON format:
{ "locations":[{ "locRef": "1234", "name": "McLean VA", "openDt": "2010-07-20", "active": true, "srcName": "Simphony", "srcVer": "18.2", "tz": "America/Denver", "curr": "USD", "workstations":[{ "wsNum":1, "wsName": "register 1" }] }] }