> This page is optimized for agents. Use the linked Markdown pages and llms.txt indexes for related API content.

# List Reservation entities.

> Fetches a summarised list of all Reservation entities

- Product: Reservations
- Section: Reservation
- Snapshot: Current
- Method: `GET`
- Path: `/api/reservations/summaries`

## Query parameters

### `organization`

Type: `number`  
Required: yes  

Organization ID

### `dateFrom`

Type: `string`  
Format: `date-time`  
Required: yes  

### `dateTo`

Type: `string`  
Format: `date-time`  
Required: yes  

### `referenceDate`

Type: `string`  
Required: no  

### `accommodation`

Type: `number`  
Required: no  

### `confirmed`

Type: `boolean`  
Required: no  

### `modifiedSince`

Type: `string`  
Format: `date-time`  
Required: no  

### `includeClosed`

Type: `boolean`  
Required: no  

### `offset`

Type: `number`  
Required: no  
Default: `0`  

### `limit`

Type: `number`  
Required: no  
Default: `25`  

## Execute with TypeScript

Package: `@recranet/sdk`  

```ts
import { RecranetApiClient } from "@recranet/sdk";

const client = new RecranetApiClient({ apiKey: process.env.RECRANET_API_KEY! });

const result = await client.reservations.summaries({
  organization: 0,
  dateFrom: new Date("2026-06-01"),
  dateTo: new Date("2026-06-01"),
});
```

## Execute with curl

```bash
curl "https://app.recranet.com/api/reservations/summaries" \
    -H "X-Api-Key: $RECRANET_API_KEY" \
    --url-query "organization=$ORGANIZATION" \
    --url-query "dateFrom=$DATEFROM" \
    --url-query "dateTo=$DATETO"
```

## Responses

### Response `200`

Category: success  

Successful response

#### `application/json`

##### Generated example

```json
[
  {
    "id": 1000,
    "token": "fdffb9ad-eeba-40da-9592-23b2c6ee067a",
    "number": "2024-0001",
    "name": "Cash",
    "reference": "",
    "source": "web",
    "date": "2024-04-01T12:12:00Z",
    "dateFrom": "2024-05-09T00:00:00Z",
    "dateTo": "2024-05-12T00:00:00Z",
    "notes": "",
    "checkin": "2024-05-09T14:00:00Z",
    "checkout": "2024-05-12T11:00:00Z",
    "numOfDays": 1000,
    "numOfPersons": 1000,
    "preferredUnitForGuest": true,
    "totalPrice": 108.5,
    "balance": 108.5,
    "advance": 95,
    "status": "cancelled",
    "closed": false,
    "paymentStatus": "payment-due",
    "orderLinesTotal": 95,
    "supplementOrderLinesTotal": 13.5,
    "supplementOrderLinesIncludedTotal": 0,
    "depositOrderLinesTotal": 0,
    "paymentChargeLinesTotal": 0,
    "cancellationInsuranceChargeLinesTotal": 0,
    "taxTotal": 0,
    "confirmed": true,
    "cancelled": false,
    "denied": false,
    "locale": "nl",
    "created": "2024-07-02T14:05:53Z",
    "modified": "2024-07-02T14:05:53Z",
    "accommodation": {
      "id": 1000,
      "title": "Zandsteeg 58",
      "locale": "nl",
      "category": {
        "id": 1000,
        "title": "Vakantiewoningen",
        "description": "Vakantiewoningen",
        "locale": "nl"
      }
    },
    "accommodationUnit": {
      "id": 1000,
      "number": "Zandsteeg 58",
      "locale": "nl"
    },
    "groupReservation": {
      "id": 1000,
      "token": "f1070d5c-b408-45b5-904a-cbd2f5f87ffb"
    },
    "guest": {
      "id": 1000,
      "email": "johnny@example.com",
      "firstName": "Johnny",
      "surname": "Cash",
      "surnamePrefix": null,
      "salutation": "male",
      "phoneNumber": "+31612345678",
      "phoneNumberHome": "+31118202019",
      "phoneNumberWork": "+31118202019",
      "address": "Akkerstraat",
      "addressNo": "143",
      "postalCode": "5293AJ",
      "locality": "Gemonde",
      "country": "NL",
      "locale": "nl",
      "birthDate": "1992-07-02T00:00:00Z",
      "membership": null,
      "iban": null,
      "ibanAccountName": null,
      "bic": null
    },
    "guests": [
      {
        "id": 1000,
        "email": "jacqueline@example.com",
        "firstName": "Jacqueline",
        "surname": "Cash",
        "surnamePrefix": null,
        "salutation": "male",
        "phoneNumber": "+31612345678",
        "phoneNumberHome": "+31118202019",
        "phoneNumberWork": "+31118202019",
        "address": "Akkerstraat",
        "addressNo": "143",
        "postalCode": "5293AJ",
        "locality": "Gemonde",
        "country": "NL",
        "locale": "nl",
        "birthDate": "1992-07-02T00:00:00Z",
        "membership": null,
        "iban": null,
        "ibanAccountName": null,
        "bic": null
      }
    ],
    "ageGroupLines": [
      {
        "id": 1000,
        "description": "Volwassenen",
        "quantity": 2,
        "ageGroupSpecification": {
          "id": 1000
        }
      }
    ],
    "orderLines": [
      {
        "id": 1000,
        "description": "Volwassenen",
        "validFrom": "2024-05-09T00:00:00Z"
      }
    ]
  }
]
```

##### Schema

###### object[]

Type: `object[]`  

###### object

Type: `object`  

###### `id`

Type: `number`  
Required: no  

###### `token`

Type: `string`  
Required: no  

###### `number`

Type: `string`  
Required: no  

###### `name`

Type: `string`  
Required: no  

###### `reference`

Type: `string`  
Required: no  

###### `source`

Type: `string`  
Required: no  
Allowed values: `office`, `owner`, `owner-for-guest`, `owner-invite`, `planning`, `reception`, `telephone`, `tour-operator`, `web`, `email`, `ical`, `cluster`, `airbnb`, `bedandbreakfast`, `belvilla`, `booking`, `expedia`, `homeaway`, `traum-ferienwohnungen`, `holidaymedia`, `nextpax`, `qenner`, `tripadvisor`, `trivago`, `ferienhausmiete`, `natuurhuisje`, `allyourz`, `vipio`, `origineel-overnachten`, `vrbo-fewo-direkt`, `vakantie-zeeland`, `anwb`, `tour-operator-other`, `groepen`, `social-media`, `micazu`, `bungalowspecials`, `campings`, `vacanceselect-travel`, `direct-booking`, `euronature`, `glamping4all`, `internatuur`, `miramare`, `apartmaji`, `suncamp`, `tui`, `pincamp`, `hundeurlaub`, `kiosk`, `rent-a-tent`, `outspot`, `acsi`, `snakeware`, `weekendjeweg`, `heerlijke-huisjes`, `ardoer`, `vakantie-adressen`, `villa-for-you`, `tradetracker`  

###### `date`

Type: `string`  
Required: no  

###### `dateFrom`

Type: `string`  
Required: no  

###### `dateTo`

Type: `string`  
Required: no  

###### `notes`

Type: `string`  
Required: no  

###### `checkin`

Type: `string`  
Required: no  

###### `checkout`

Type: `string`  
Required: no  

###### `numOfDays`

Type: `number`  
Required: no  

###### `numOfPersons`

Type: `number`  
Required: no  

###### `preferredUnitForGuest`

Type: `boolean`  
Required: no  

###### `totalPrice`

Type: `number`  
Required: no  

###### `balance`

Type: `number`  
Required: no  

###### `advance`

Type: `number`  
Required: no  

###### `status`

Type: `string`  
Required: no  
Allowed values: `cancelled`, `denied`, `imported`, `open`, `confirmed`, `option`, `option-expired`, `session`  

###### `closed`

Type: `boolean`  
Required: no  

###### `paymentStatus`

Type: `string`  
Required: no  
Allowed values: `payment-due`, `payment-advance-received`, `payment-partially-received`, `payment-received`, `payment-overpaid`  

###### `orderLinesTotal`

Type: `number`  
Required: no  

###### `supplementOrderLinesTotal`

Type: `number`  
Required: no  

###### `supplementOrderLinesIncludedTotal`

Type: `number`  
Required: no  

###### `depositOrderLinesTotal`

Type: `number`  
Required: no  

###### `paymentChargeLinesTotal`

Type: `number`  
Required: no  

###### `cancellationInsuranceChargeLinesTotal`

Type: `number`  
Required: no  

###### `taxTotal`

Type: `number`  
Required: no  

###### `confirmed`

Type: `boolean`  
Required: no  

###### `cancelled`

Type: `boolean`  
Required: no  

###### `denied`

Type: `boolean`  
Required: no  

###### `locale`

Type: `string`  
Required: no  

###### `created`

Type: `string`  
Required: no  

###### `modified`

Type: `string`  
Required: no  

###### `accommodation`

Type: `object`  
Required: no  

###### `id`

Type: `number`  
Required: no  

###### `title`

Type: `string`  
Required: no  

###### `locale`

Type: `string`  
Required: no  

###### `category`

Type: `object`  
Required: no  

###### `id`

Type: `number`  
Required: no  

###### `title`

Type: `string`  
Required: no  

###### `description`

Type: `string`  
Required: no  

###### `locale`

Type: `string`  
Required: no  

###### `accommodationUnit`

Type: `object`  
Required: no  

###### `id`

Type: `number`  
Required: no  

###### `number`

Type: `string`  
Required: no  

###### `locale`

Type: `string`  
Required: no  

###### `groupReservation`

Type: `object`  
Required: no  

###### `id`

Type: `number`  
Required: no  

###### `token`

Type: `string`  
Required: no  

###### `guest`

Type: `object`  
Required: no  

###### `id`

Type: `number`  
Required: no  

###### `email`

Type: `string`  
Required: no  

###### `firstName`

Type: `string`  
Required: no  

###### `surname`

Type: `string`  
Required: no  

###### `surnamePrefix`

Type: `string`  
Required: no  

###### `salutation`

Type: `string`  
Required: no  
Allowed values: `male`, `female`, `family`  

###### `phoneNumber`

Type: `string`  
Required: no  

###### `phoneNumberHome`

Type: `string`  
Required: no  

###### `phoneNumberWork`

Type: `string`  
Required: no  

###### `address`

Type: `string`  
Required: no  

###### `addressNo`

Type: `string`  
Required: no  

###### `postalCode`

Type: `string`  
Required: no  

###### `locality`

Type: `string`  
Required: no  

###### `country`

Type: `string`  
Required: no  

###### `locale`

Type: `string`  
Required: no  

###### `birthDate`

Type: `string`  
Required: no  

###### `membership`

Type: `string`  
Required: no  

###### `iban`

Type: `string`  
Required: no  

###### `ibanAccountName`

Type: `string`  
Required: no  

###### `bic`

Type: `string`  
Required: no  

###### `guests`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `id`

Type: `number`  
Required: no  

###### `email`

Type: `string`  
Required: no  

###### `firstName`

Type: `string`  
Required: no  

###### `surname`

Type: `string`  
Required: no  

###### `surnamePrefix`

Type: `string`  
Required: no  

###### `salutation`

Type: `string`  
Required: no  
Allowed values: `male`, `female`, `family`  

###### `phoneNumber`

Type: `string`  
Required: no  

###### `phoneNumberHome`

Type: `string`  
Required: no  

###### `phoneNumberWork`

Type: `string`  
Required: no  

###### `address`

Type: `string`  
Required: no  

###### `addressNo`

Type: `string`  
Required: no  

###### `postalCode`

Type: `string`  
Required: no  

###### `locality`

Type: `string`  
Required: no  

###### `country`

Type: `string`  
Required: no  

###### `locale`

Type: `string`  
Required: no  

###### `birthDate`

Type: `string`  
Required: no  

###### `membership`

Type: `string`  
Required: no  

###### `iban`

Type: `string`  
Required: no  

###### `ibanAccountName`

Type: `string`  
Required: no  

###### `bic`

Type: `string`  
Required: no  

###### `ageGroupLines`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `id`

Type: `number`  
Required: no  

###### `description`

Type: `string`  
Required: no  

###### `quantity`

Type: `number`  
Required: no  

###### `ageGroupSpecification`

Type: `object`  
Required: no  

###### `id`

Type: `number`  
Required: no  

###### `orderLines`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `id`

Type: `number`  
Required: no  

###### `description`

Type: `string`  
Required: no  

###### `validFrom`

Type: `string`  
Required: no  

###### `validThrough`

Type: `string`  
Required: no  

###### `quantity`

Type: `number`  
Required: no  

###### `numOfDays`

Type: `number`  
Required: no  

###### `numOfPersons`

Type: `number`  
Required: no  

###### `unitPrice`

Type: `number`  
Required: no  

###### `taxRate`

Type: `number`  
Required: no  

###### `taxBaseAmount`

Type: `number`  
Required: no  

###### `taxTotal`

Type: `number`  
Required: no  

###### `totalPricePerDay`

Type: `number`  
Required: no  

###### `totalPrice`

Type: `number`  
Required: no  

###### `supplementOrderLines`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `id`

Type: `number`  
Required: no  

###### `description`

Type: `string`  
Required: no  

###### `quantity`

Type: `number`  
Required: no  

###### `numOfDays`

Type: `number`  
Required: no  

###### `numOfPersons`

Type: `number`  
Required: no  

###### `unitPrice`

Type: `number`  
Required: no  

###### `totalPricePerDay`

Type: `number`  
Required: no  

###### `taxRate`

Type: `number`  
Required: no  

###### `taxBaseAmount`

Type: `number`  
Required: no  

###### `taxTotal`

Type: `number`  
Required: no  

###### `totalPrice`

Type: `number`  
Required: no  

###### `required`

Type: `boolean`  
Required: no  

###### `included`

Type: `boolean`  
Required: no  

###### `supplement`

Type: `object`  
Required: no  

###### `id`

Type: `number`  
Required: no  

###### `cancellationInsuranceChargeLines`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `id`

Type: `number`  
Required: no  

###### `type`

Type: `string`  
Required: no  
Allowed values: `insurance`, `policy-fee`, `insurance-tax`  

###### `amount`

Type: `number`  
Required: no  

###### `percentage`

Type: `number`  
Required: no  

###### `taxRate`

Type: `number`  
Required: no  

###### `taxBaseAmount`

Type: `number`  
Required: no  

###### `taxTotal`

Type: `number`  
Required: no  

###### `totalPrice`

Type: `number`  
Required: no  

###### `depositOrderLines`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `id`

Type: `number`  
Required: no  

###### `description`

Type: `string`  
Required: no  

###### `taxRate`

Type: `number`  
Required: no  

###### `taxBaseAmount`

Type: `number`  
Required: no  

###### `taxTotal`

Type: `number`  
Required: no  

###### `totalPrice`

Type: `number`  
Required: no  

###### `paymentChargeLines`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `id`

Type: `number`  
Required: no  

###### `taxRate`

Type: `number`  
Required: no  

###### `taxBaseAmount`

Type: `number`  
Required: no  

###### `taxTotal`

Type: `number`  
Required: no  

###### `totalPrice`

Type: `number`  
Required: no  

###### `registrationNumberEntries`

Type: `object[]`  
Required: no  

###### object

Type: `object`  

###### `id`

Type: `number`  
Required: no  

###### `number`

Type: `string`  
Required: no  

###### `validFrom`

Type: `string`  
Required: no  

###### `validThrough`

Type: `string`  
Required: no  

### Response `400`

Category: client-error  

Bad request

#### `application/json`

##### Example

```json
{
  "statusCode": 400,
  "description": "Bad request",
  "errors": [
    "Bad request"
  ]
}
```

##### Schema

###### object

Type: `object`  

## Related representations

- [Human documentation](/reservations/methods/summaries/)
- [TypeScript Markdown](/reservations/methods/summaries.md?lang=typescript)
- [curl Markdown](/reservations/methods/summaries.md?lang=curl)
- [site llms.txt](/llms.txt)
- [product llms.txt](/reservations/llms.txt)
- [snapshot llms.txt](/reservations/llms.txt)
