# Calendar feed reads

How often each consumer read a calendar feed, per day

Endpoint: `https://api.bookingmood.com/v1/calendar_feed_reads`, supporting `GET`. Authenticate with the header `Authorization: Bearer YOUR_API_KEY` (see [authentication](https://www.bookingmood.com/tr-TR/api-reference/authentication.md)).

## The calendar feed read object

| Attribute | Type | Description |
| --- | --- | --- |
| `id` | `int64` | Unique identifier. Read-only: set by the database. |
| `organization_id` | `uuid` | Identifier of the related organization. References [`organizations.id`](https://www.bookingmood.com/tr-TR/api-reference/organizations.md). |
| `product_id` | `uuid \| null` | Identifier of the unit whose feed was read. Empty for the feed of the organization. References [`products.id`](https://www.bookingmood.com/tr-TR/api-reference/products.md). |
| `date` | `date` | Date of the reads. |
| `include_booking_details` | `boolean` | Whether the reads used the secret that includes guest details. |
| `last_read_at` | `timestamp with time zone` | Time of the last read on the date. |
| `read_count` | `int32` | Number of reads on the date. |
| `referrer` | `text` | Referrer of the requests. |

```json
{
  "id": 0,
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "product_id": "00000000-0000-0000-0000-000000000000",
  "date": "2026-11-22",
  "include_booking_details": false,
  "last_read_at": "2026-11-22T23:21:20.361Z",
  "read_count": 1,
  "referrer": ""
}
```

### Related resources

Embed related resources with the [`select` parameter](https://www.bookingmood.com/tr-TR/api-reference/selecting.md), e.g. `select=*,organizations(*)`. Resources related through more than one column need the column as a hint, like `table!column(*)`.

| Embed | Type | Description |
| --- | --- | --- |
| `organizations(*)` | `object \| null` | The [organization](https://www.bookingmood.com/tr-TR/api-reference/organizations.md) referenced by `organization_id`. |
| `products(*)` | `object \| null` | The [product](https://www.bookingmood.com/tr-TR/api-reference/products.md) referenced by `product_id`. |

## List calendar feed reads

`GET /v1/calendar_feed_reads` · requires the `bookings:read` scope

Filter on any attribute with `column=operator.value` (see [filtering](https://www.bookingmood.com/tr-TR/api-reference/filtering.md)). Choose columns and embed related resources with `select` (see [selecting](https://www.bookingmood.com/tr-TR/api-reference/selecting.md)), and sort and paginate with `order`, `limit` and `offset` (see [sorting and pagination](https://www.bookingmood.com/tr-TR/api-reference/sorting-pagination.md)).

```bash
curl "https://api.bookingmood.com/v1/calendar_feed_reads?select=*&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

Responses:

- `200`: A list of calendar feed reads with the selected columns. `206` when the list is a partial range.
- `400`: The request is malformed, for example an unknown column or an invalid filter.
- `401`: The API key is missing or invalid.
- `403`: The API key or access token doesn't have the scope this request needs.
- `429`: The API key made more requests per minute than its rate limit allows. Retry after the number of seconds in the `Retry-After` header.

Errors have a JSON body with a `code`, `message`, `details` and `hint`. See the [introduction](https://www.bookingmood.com/tr-TR/api-reference.md) for more on errors. The full API is described by the OpenAPI spec at https://api.bookingmood.com/v1/openapi.json.
