---
title: "Get a list of doorlock keys for a specific app client and property."
method: GET
path: "/doorlock/v1/keys/{propertyId}"
tags: ["Door Locks"]
---

# Get a list of doorlock keys for a specific app client and property.

`GET /doorlock/v1/keys/{propertyId}`

## Request

- Base URL: `https://api.cloudbeds.com`
- URL: `https://api.cloudbeds.com/doorlock/v1/keys/{propertyId}`
- Auth: OAuth 2
  - Authorization code: `https://api.cloudbeds.com/auth/oauth/authorize`
  - Token URL: `https://api.cloudbeds.com/auth/oauth/token` scopes: `read:doorLockKey`

## Path parameters

- `propertyId` integer, required

## Query parameters

- `reservationId` ReservationId (unresolved $ref)
- `subReservationId` SubReservationId (unresolved $ref)
- `keyIds` string

## Response `200`

List of door lock keys.

- DoorLockKeyListResponseSchema
  - `data` DoorLockKeyCollectionResponseSchema[], nullable, required
    - DoorLockKeyResponseSchema[]
      - `keyId` string, required
      - `propertyId` string, required
      - `reservationId` string, required
      - `subReservationId` string, required
      - `issuerId` string, required
      - `guestId` string, nullable
      - `rooms` string[], required
      - `commonRooms` string[], required
      - `startDateTime` string, Y-m-d\TH:i:sP, required
      - `endDateTime` string, Y-m-d\TH:i:sP, required
      - `encoder` string, nullable
      - `keyCode` string, nullable
      - `keyType` string, required
      - `mobileId` string, nullable
      - `externalId` string, nullable
      - `status` string, required
      - `errorMessage` string, nullable
      - `createdAt` string, required
      - `updatedAt` string, nullable

## Other responses

- `400`: Bad Request response
- `500`: Internal server error

---

[API](https://skmtc.dev/cloudbeds/apis/cloudbeds-api-v2.md) - [All operations](https://skmtc.dev/cloudbeds/apis/cloudbeds-api-v2/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudbeds/apis/cloudbeds-api-v2/revisions/69bffac143cc?raw)