---
title: "Get calendar block logs"
method: GET
path: "/api/block-logs"
tags: ["Calendar Logs"]
---

# Get calendar block logs

`GET /api/block-logs`

Retrieves a list of block logs based on the specified filters.

## Query parameters

- `listingId` string
- `userName` string
- `startDate` string, date
- `endDate` string, date
- `blockType` 'manual' | 'preparation_time'
- `eventType` 'created' | 'updated' | 'removed'

## Response `200`

The record has been successfully fetched

- object[]
  - `propertyName` string, required — The name of the property associated with the log.
  - `userName` string, required — The name of the user who made the changes.
  - `startDate` string, date, required — The start date of the block.
  - `endDate` string, date, required — The end date of the block.
  - `blockType` string, required — The type of block applied.
  - `eventType` 'BLOCK_CREATED' | 'BLOCK_UPDATED' | 'BLOCK_REMOVED', required — The event type related to the block.
  - `note` string, required — A note related to the block.
  - `reason` 'Owner block' | 'Offboarded' | 'Migrated unit block' | 'Maintenance' | 'Onboarding' | 'Emergency out of order' | 'Do not sell' | 'Deactivated' | 'Other', required — The reason for the block.
  - `doneAt` string, date, required — The date when the block action was completed.

## Other responses

- `400` — Bad Request - Invalid parameters provided
- `401` — Unauthorized - Authentication credentials are missing or invalid
- `403` — Forbidden - You do not have permission to access this resource
- `404` — No block logs found for this listing
- `500` — Internal Server Error - Something went wrong on the server

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/revisions/7c62644070f2/schema)