---
updatedAt: 2026-05-12T14:24:12.000Z
agentTools:
  projectIndex: https://open-api-docs.guesty.com/llms.txt
---

# Get reservation logs

Retrieve a paginated list of activity log entries for a specific reservation.

# OpenAPI definition

```json
{
  "openapi": "3.0.3",
  "info": {
    "title": "GUESTY OPEN API",
    "description": "Guesty Open API documentation",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://open-api.guesty.com/v1"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "tags": [
    {
      "name": "Reservations Open Api [Beta]"
    }
  ],
  "paths": {
    "/reservation-logs/{reservationId}": {
      "get": {
        "operationId": "ReservationsLogsOpenApiController_getReservationLogs",
        "summary": "Get reservation logs",
        "description": "Retrieve a paginated list of activity log entries for a specific reservation.",
        "parameters": [
          {
            "name": "reservationId",
            "required": true,
            "in": "path",
            "description": "The unique identifier of the reservation to retrieve logs for",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cursor",
            "required": false,
            "in": "query",
            "description": "The ID of the last log entry from the previous response, used as a cursor for pagination. Pass the `logId` of the last item received to retrieve the next page of results.",
            "schema": {
              "example": "5f92cbf10cf217478ba93561",
              "type": "string"
            }
          },
          {
            "name": "limit",
            "required": false,
            "in": "query",
            "description": "Maximum number of items to return per response",
            "schema": {
              "minimum": 1,
              "maximum": 20,
              "default": 20,
              "example": 20,
              "type": "number"
            }
          },
          {
            "name": "sort",
            "required": false,
            "in": "query",
            "description": "Sort order of the results",
            "schema": {
              "default": "desc",
              "enum": [
                "asc",
                "desc"
              ],
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successfully retrieved reservation logs",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "description": "List of reservation log entries",
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "logId": {
                            "type": "string",
                            "description": "Unique identifier of the log entry"
                          },
                          "event": {
                            "type": "string",
                            "description": "Human-readable description of what changed"
                          },
                          "at": {
                            "format": "date-time",
                            "type": "string",
                            "description": "Timestamp of when the event occurred",
                            "example": "2025-06-23T13:17:26.870Z"
                          },
                          "by": {
                            "type": "string",
                            "description": "Name of the person or system that triggered the event"
                          },
                          "label": {
                            "type": "string",
                            "description": "Category label for the event (e.g. \"Created\", \"Updated\", \"Cancelled\")",
                            "example": "Updated"
                          },
                          "source": {
                            "type": "string",
                            "description": "Source or channel that originated the event (e.g. \"Airbnb\", \"Direct\")",
                            "example": "Direct"
                          },
                          "details": {
                            "description": "List of individual field-level changes included in this event",
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "label": {
                                  "type": "string",
                                  "description": "Label of the changed field"
                                },
                                "value": {
                                  "type": "string",
                                  "description": "Value of the changed field"
                                }
                              },
                              "required": [
                                "label",
                                "value"
                              ]
                            }
                          },
                          "activityType": {
                            "type": "number",
                            "description": "Numeric identifier of the activity type",
                            "example": 1
                          }
                        },
                        "required": [
                          "logId",
                          "event",
                          "at",
                          "by"
                        ]
                      }
                    }
                  },
                  "required": [
                    "items"
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Returned if required fields are missing or there is a validation error in the request"
          },
          "404": {
            "description": "Returned if the reservation was not found"
          },
          "500": {
            "description": "Indicates server-side error while processing the request"
          }
        },
        "tags": [
          "Reservations Open Api [Beta]"
        ]
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "apiKey",
        "name": "authorization",
        "in": "header"
      }
    }
  },
  "x-kong-upstream-prefix": "/integrations/brands",
  "x-kong-route-transformations": [
    {
      "configuration": "v1",
      "routeExtpath": "/account-brands",
      "stripPrefix": "/v1/account-brands"
    }
  ]
}
```