Method | Path |
---|---|
GET |
https://agora.olery.com/v3/companies/:id/gei |
Returns the (average) Guest Experience Index (as times series)
Output Format
The meta
field contains general information about the property.
The aggregated data is returned as an Array of JSON objects in the
data
field. Each object has the following fields:
Field | Data Types | Description |
---|---|---|
gei | Float | Guest Experience Index value |
date | Date | Start date of each time period, if per parameter is used |
Parameters
Parameter | Parameter Type | Data Types | Required | Description |
---|---|---|---|---|
id | path | Integer | true | ID of the company |
start_date | query | Date | true | Start date in ISO 8601 format |
end_date | query | Date | true | End date in ISO 8601 format |
per | query | String | false | Date grouping (day, month, quarter, year) |
Grouping with the segment
parameter is not possible for the GEI,
because it is a wholistic value representing the experiences from
all guests.
Example Call
https://agora.olery.com/v3/companies/38/gei?start_date=2018-01-01&end_date=2018-03-31&per=month&auth_token=XXX
Example Output
{
"meta":{
"company":{
"id":38,
"name":"Hotel ABC"
}
},
"data":[
{
"date":"2018-01-01",
"gei":81.8382035145927
},
{
"date":"2018-02-01",
"gei":82.837304103693
},
{
"date":"2018-03-01",
"gei":83.5878121009877
}
]
}
Response Statuses
Status Code | Reason |
---|---|
200 | OK |
404 | Company not found |
403 | No access, no authentication token |
400 | Missing or incorrect dates |