...
| Parameter | Description |
|---|---|
hotel_id | Property Numerical identifier Cannot be null |
limit | The maximum number of forms to return, up to 50. |
Retrieve Single Form
| Anchor | ||||
|---|---|---|---|---|
|
...
| Code Block |
|---|
GET v3/requests |
Request URL Parameters
| Parameter | Description |
|---|---|
hotel_id | Property Numerical identifier Cannot be null |
limit | The maximum number of requests to return, up to 50. |
| offset integer optional, default is 0 | The number of requests to skip over, where the ordering is consistent but unspecified. |
| status string optional, default is 0 | Filter Requests that match a specific status. Use Unresolved to retrieve all requests that have any status other than completed or cancelled. |
| priority string optional, default is "new" | Filter Requests that match a specific priority. |
| room string optional |
|
| rooms array optional |
|
| category string optional |
|
Retrieve Single Request
This call returns a specific request for property.
...
| Code Block |
|---|
POST v3/requests |
Request URL Parameters
| Parameter | Description |
|---|---|
hotel_id | Property Numerical identifier Cannot be null |
Guest | see list of supported strings |
| Category string required | form category name from the categories endpoint |
| room string optional | Guest room for their booking |
| booking_id string optional | The reservation identifier for the guests stay with the property, if applicable. |
| guest_notify boolean required | Should an email be sent to the guest notifying them of this requests creation? Recommended false |
| staff_username string optional |
|
| status string optional default "New" |
|
priority |
|
| form_name string required | Name of the form we are creating this request for from the forms endpoint |
| form_fields array required | details of the form request. Needs to match any required form_fields for the specified form_name from the forms forms endpoint |
Example Request
| Code Block |
|---|
{
"hotel_id": 2,
"room": "32",
"booking_id": "1332025-4X",
"guest": {
"email": "joeb@banks.com",
"name": "Joe Banks",
"phone": "7075551414"
},
"guest_notify": false,
"form_category": "Treatment",
"form_name": "Spa Menu",
"form_fields": {
"Notes": "We'd like hot towels and a room to meditate in",
"swedish1": 2,
"pregnancy2": 1
}
} |
...
| Code Block |
|---|
{
"requests": {
"id": 878,
"booking_id": "1332025-4X",
"room": "32",
"guest": {
"name": "Joe Banks",
"email": "joeb@banks.com",
"phone_number": "7075551414"
},
"created_at": "2020-02-12 15:43:15",
"updated_at": "2020-02-12 15:43:15",
"length_open": "1 second",
"status": "New",
"priority": "Normal",
"assigned": null,
"category": {
"id": 8,
"name": "Treatment"
},
"request_details": [
{
"name": "Notes",
"value": "We'd like hot towels and a room to meditate in",
"amount": null,
"type": "text"
},
{
"name": "Swedish1",
"value": "2",
"amount": "80",
"type": "amount"
},
{
"name": "Pregnancy2",
"value": "1",
"amount": "140",
"type": "amount"
}
],
"comments": {
"guest_comments": [],
"staff_notes": []
}
},
"api_version": 3,
"status": "success",
"request_uuid": "a25a7d79-ba8a-40a3-92a6-02862f7a16c2"
}
|
...
Request URL Parameters
| Parameter | Description |
|---|---|
| id integer required | The ID of the request resource being managed |
hotel_id | Property Numerical identifier Cannot be null |
Guest | see list of supported strings |
| Category string required | form category name from the categories endpoint |
| room string optional | Guest room for their booking |
| booking_id string optional | The reservation identifier for the guests stay with the property, if applicable. |
| guest_notify boolean required | Should an email be sent to the guest notifying them of this requests update? Recommended false |
| staff_username string optional |
|
| status string optional |
|
priority |
|
| form_name string required | Name of the form we are creating this request for from the forms endpoint |
| form_fields array required | details of the form request. Needs to match any required form_fields for the specified form_name from the forms forms endpoint |
Requests Guest Array
| Anchor | ||||
|---|---|---|---|---|
|
...