Location Info

Supported App Types: On-Prem and Cloud.

Description: Get location information by passing the location ID.

Path: /api/partners/v1/locations/:locationId

Method: GET

Query Params: partnerTenantId=<PARTNER_TENANT_ID>

Headers: X-API-KEY=<X-API-KEY>

Response Codes
  • 404 – When location is not found.

  • 403 – When the supplied partnerTenantId is not authorized to access the location.

  • 200 – Success

Response Headers

CONTENT_TYPE: application/json

Sample JSON:
{
“location”: {
“locationId”: “location-d827508f”,
“name”: “Location Level 3”,
“inferredLocationTypes”: [
“FLOOR”
],
“parent”: {
“locationId”: “location-3e306fd1”,
“name”: “Location Level 2”,
“inferredLocationTypes”: [
“NETWORK”
],
“parent”: {
“locationId”: “location-d4a2b651”,
“name”: “Location Level 2”,
“inferredLocationTypes”: [
“CAMPUS”
],
“parent”: {
“locationId”: “location-da34853c”,
“name”: “Location Level 1”,
“inferredLocationTypes”: [
“MSE”
],
“parent”: {
“locationId”: “location-91cdc6dc”,
“name”: “Location Level Root”,
“inferredLocationTypes”: [
“ROOT”
]
}
}
}
}
},
“locationDetails”: {
“timeZone”: “Europe/London”,
“city”: “”,
“state”: “”,
“country”: “”,
“category”: “”,
“metadata”: [

],
“latitude”: 0.0,
“longitude”: 0.0
}
}