---
title: "Returns the number of reservations fulfilling the criteria specified in the parameters."
method: GET
path: "/booking/v1/reservations/$count"
tags: ["Reservation"]
---

# Returns the number of reservations fulfilling the criteria specified in the parameters.

`GET /booking/v1/reservations/$count`

## Request

- Base URL: `https://api.apaleo.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.apaleo.com/booking/v1/reservations/$count`
- Auth: OAuth 2
  - Implicit: `https://identity.apaleo.com/connect/authorize`
  - Scopes: `reservations.read`, `reservations.manage`, `admin`
- TypeScript: <https://skmtc.dev/apaleo/apis/apaleo-booking-api/docs/booking/v1/reservations/$count/get.ts> (a function with typed inputs; its response is checked against the schema)

If no parameters are set, returns the total count of reservations.<br>You must have at least one of these scopes: 'reservations.read, reservations.manage'.<br>For fine-grained clients, you must have this permission: 'core.reservations.read'.

## Query parameters

- `bookingId` string
- `propertyIds` string[]
- `ratePlanIds` string[]
- `companyIds` string[]
- `unitIds` string[]
- `unitGroupIds` string[]
- `unitGroupTypes` string[]
- `blockIds` string[]
- `marketSegmentIds` string[]
- `status` string[]
- `dateFilter` 'Arrival' | 'Departure' | 'Stay' | 'Creation' | 'Modification' | 'Cancellation' | 'ArrivalAndCheckIn' | 'DepartureAndCheckOut'
- `from` string, date-time
- `to` string, date-time
- `channelCode` string[]
- `sources` string[]
- `validationMessageCategory` string[]
- `externalCode` string
- `textSearch` string
- `balanceFilter` string[]
- `allFoliosHaveInvoice` boolean
- `isPreCheckedIn` boolean
- `hasActivePaymentAccount` boolean
- `externalReferences` string[]

## Response `200`

Success

- CountModel
  - `count` integer, required

## Other responses

- `400`: Bad request.
- `401`: You are unauthorized.
- `403`: Forbidden.
- `404`: The Request-URI could not be found.
- `422`: Validation errors in the request body or query params.
- `499`: Client closed request.
- `500`: An unexpected error occurred.
- `503`: The server is currently unavailable. Please try later.

## Changes

> 7 revisions in range; 1 not diffed.

- **2026-09-01** `6510a7df7143`: 4 info
  - added the new optional `query` request parameter `externalReferences`
  - added the new optional `query` request parameter `hasActivePaymentAccount`
  - added the new optional `query` request parameter `isPreCheckedIn`
  - added the non-success response with the status `499`

[Operation history](https://skmtc.dev/apaleo/apis/apaleo-booking-api/changes/booking/v1/reservations/$count/get.md)

---

[API](https://skmtc.dev/apaleo/apis/apaleo-booking-api.md) - [All operations](https://skmtc.dev/apaleo/apis/apaleo-booking-api/llms.txt) - [OpenAPI document](https://skmtc.dev/apaleo/apis/apaleo-booking-api/revisions/39bc5321f19c?raw)