DigitalGuest logo
API docs by Redocly

DigitalGuest (API)

Download OpenAPI specification:Download

API Support: integrations@digitalguest.com

Introduction

DigitalGuest provides a modern, RESTful API for one-way integration with our guest journey platform. Our open API supports creating and modifying booking objects, using JSON as the data format.

Getting Started

If you would like to inquire about integrating towards our API, then please send your request to integrations@digitalguest.com and we will get back to you.

For development you should use the sandbox environment at api-dev.digitalguest.com. If you run into any issues, contact our API support and remember to include the eventId from the error response.

To register a new booking, send a POST request with the booking information. This should be done before sending any update requests, but it is not a hard requirement. When the guest checks in, or out, send a PUT request with state changed. To cancel the booking, send a DELETE request. Many of the booking and guest fields are optional, but they should be filled out if possible.

Status codes

Standard HTTP status codes along with objects are used to return statuses. Responses may include additional information in the optional data field. All requests may return 400, 401, 403, or 500, so they're excluded from the examples for brevity.

Code Message
200 Success.
201 Resource created.
400 Bad request, likely due to missing or invalid input.
401 Missing or invalid authentication.
403 Forbidden.
404 The requested resource doesn't exist.
500 Internal server error. Contact us if the issue persists.

Bookings

Get booking

Authorizations:
Bearer
path Parameters
propertyId
required
string non-empty
Example: TheHendrixHotel

Property ID.

bookingId
required
string non-empty
Example: 8324792

Unique ID used to reference bookings.

Responses

Response samples

Content type
application/json
Example
{
  • "type": "accommodation",
  • "state": "expected",
  • "arrival": "2020-12-13T14:00:00.000Z",
  • "departure": "2020-12-21T11:00:00.000Z",
  • "guest": {
    },
  • "attributes": {
    },
  • "unit": {
    },
  • "rateCode": "BAR2"
}

Create booking

Authorizations:
Bearer
path Parameters
propertyId
required
string non-empty
Example: TheHendrixHotel

Property ID.

bookingId
required
string non-empty
Example: 8324792

Unique ID used to reference bookings.

Request Body schema: application/json
type
required
string
state
required
string
Enum: "expected" "arrived" "departed" "cancelled"

Booking state.

arrival
string <date-time>

Arrival date.

departure
string <date-time>

Departure date.

required
object (Guest)

Contact person for the booking.

email or phone must be present for the guest to receive messages, ideally both.

object (Attributes)
object
rateCode
string

Code identifying the booking's rate plan.

Responses

Request samples

Content type
application/json
Example
{
  • "type": "accommodation",
  • "state": "expected",
  • "arrival": "2020-12-13T14:00:00.000Z",
  • "departure": "2020-12-21T11:00:00.000Z",
  • "guest": {
    },
  • "attributes": {
    },
  • "unit": {
    },
  • "rateCode": "BAR2"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Booking updated.",
  • "eventId": "3d4570c3",
  • "data": {
    }
}

Update booking

Authorizations:
Bearer
path Parameters
propertyId
required
string non-empty
Example: TheHendrixHotel

Property ID.

bookingId
required
string non-empty
Example: 8324792

Unique ID used to reference bookings.

Request Body schema: application/json
type
required
string
state
required
string
Enum: "expected" "arrived" "departed" "cancelled"

Booking state.

arrival
string <date-time>

Arrival date.

departure
string <date-time>

Departure date.

required
object (Guest)

Contact person for the booking.

email or phone must be present for the guest to receive messages, ideally both.

object (Attributes)
object
rateCode
string

Code identifying the booking's rate plan.

Responses

Request samples

Content type
application/json
Example
{
  • "type": "accommodation",
  • "state": "expected",
  • "arrival": "2020-12-13T14:00:00.000Z",
  • "departure": "2020-12-21T11:00:00.000Z",
  • "guest": {
    },
  • "attributes": {
    },
  • "unit": {
    },
  • "rateCode": "BAR2"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Booking updated.",
  • "eventId": "3d4570c3",
  • "data": {
    }
}

Reviews

Get reviews

Returns NPS reviews for a property within a reviewed date range. Guest data may be anonymized; anonymized reviews are still returned and marked accordingly.

Authorizations:
Bearer
path Parameters
propertyId
required
string non-empty
Example: TheHendrixHotel

Property ID.

query Parameters
reviewedFrom
required
string <date-time>
Example: reviewedFrom=2026-01-01T00:00:00.000Z

Only include reviews with reviewed >= reviewedFrom.

reviewedTo
required
string <date-time>
Example: reviewedTo=2026-02-01T00:00:00.000Z

Only include reviews with reviewed <= reviewedTo.

offset
integer >= 0
Default: 0

Pagination offset.

limit
integer [ 1 .. 500 ]
Default: 100

Max number of reviews to return (max 500).

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Reviews returned.",
  • "eventId": "3d4570c3",
  • "data": {
    }
}

Other

Ping

Test connectivity

Authorizations:
Bearer

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "message": "Pong.",
  • "eventId": "3d4570c3",
  • "data": {
    }
}