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

# Get available accommodation units.

- Product: Planning
- Section: Planning
- Snapshot: Current
- Method: `GET`
- Path: `/api/planning/available_units`

## Query parameters

### `date`

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

### `organization`

Type: `number`  
Required: yes  

### `dateFrom`

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

### `dateTo`

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

### `accommodation`

Type: `number`  
Required: no  

### `accommodationUnitFeatures[]`

Type: `number[]`  
Required: no  

#### number

Type: `number`  

### `excludedReservation`

Type: `number`  
Required: no  

### `public`

Type: `boolean`  
Required: no  

## 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.planning.availableUnits({
  organization: 0,
  dateFrom: new Date("2026-06-01"),
  dateTo: new Date("2026-06-01"),
});
```

## Execute with curl

```bash
curl "https://app.recranet.com/api/planning/available_units" \
    -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": 0,
    "number": "number",
    "locale": "locale",
    "content": {
      "id": 0,
      "locale": "locale",
      "description": "description"
    },
    "features": [
      {
        "id": 1000
      }
    ],
    "latitude": "latitude",
    "longitude": "longitude",
    "public": true,
    "active": true,
    "availabilityEnabled": false,
    "available": true,
    "petsAllowed": true,
    "area": 0,
    "created": "created",
    "modified": "modified",
    "wifiConfiguration": {
      "id": 0,
      "securityProtocol": "securityProtocol",
      "ssid": "ssid",
      "accommodationUnits": [
        {
          "id": 1000
        }
      ],
      "psk": "psk"
    }
  }
]
```

##### Schema

###### AccommodationUnit[]

Type: `AccommodationUnit[]`  

###### AccommodationUnit

Type: `AccommodationUnit`  

###### `id`

Type: `number`  
Required: yes  

###### `number`

Type: `string`  
Required: yes  

###### `latitude`

Type: `string`  
Required: no  

###### `longitude`

Type: `string`  
Required: no  

###### `public`

Type: `boolean`  
Required: no  
Default: `true`  

###### `active`

Type: `boolean`  
Required: no  
Default: `true`  

###### `availabilityEnabled`

Type: `boolean`  
Required: no  
Default: `false`  

###### `available`

Type: `boolean`  
Required: no  
Default: `true`  

###### `petsAllowed`

Type: `boolean`  
Required: no  

###### `area`

Type: `number`  
Required: no  

###### `locale`

Type: `string`  
Required: yes  

###### `created`

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

###### `modified`

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

###### `content`

Type: `AccommodationUnitContent`  
Required: yes  

###### `id`

Type: `number`  
Required: yes  

###### `description`

Type: `string`  
Required: no  

###### `locale`

Type: `string`  
Required: yes  

###### `wifiConfiguration`

Type: `AccommodationUnitWifiConfiguration`  
Required: no  

###### AccommodationUnitWifiConfiguration

Type: `AccommodationUnitWifiConfiguration`  

###### `id`

Type: `number`  
Required: yes  

###### `securityProtocol`

Type: `string`  
Required: yes  

###### `ssid`

Type: `string`  
Required: yes  

###### `psk`

Type: `string`  
Required: no  

###### `accommodationUnits`

Type: `object[]`  
Required: yes  

###### object

Type: `object`  

###### `id`

Type: `number`  
Required: no  

###### `features`

Type: `object[]`  
Required: yes  

###### object

Type: `object`  

###### `id`

Type: `number`  
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](/planning/methods/available-units/)
- [TypeScript Markdown](/planning/methods/available-units.md?lang=typescript)
- [curl Markdown](/planning/methods/available-units.md?lang=curl)
- [site llms.txt](/llms.txt)
- [product llms.txt](/planning/llms.txt)
- [snapshot llms.txt](/planning/llms.txt)