---
title: "Get guest code"
method: GET
path: "/guest-code"
tags: ["Guesty Locks Manager"]
---

# Get guest code

`GET /guest-code`

Get guest code data for reservations with future check-out times, by reservation ID.
      Note: The main guest codes are codes with "purpose" set to "GUEST".
      Codes with "purpose" set to "GUEST_BACKUP" are codes to share with guests in case the "GUEST" code has errors, starting from the check-in day.
      "GUEST_BACKUP" codes are a dynamic pool of codes associated with reservations on check-in day. When fetching a "GUEST_BACKUP" code before the check-in day, the code is not guaranteed to stay the same until the check-in day.

## Query parameters

- `reservationId` string, required

## Response `200`

Success response

- object
  - `codes` object[], required
    - `code` string, required
    - `purpose` string, required
    - `status` string, required
    - `startsAt` string, date-time, nullable, required
    - `endsAt` string, date-time, nullable, required
    - `lockIds` string[], required
  - `locks` object[], required
    - `id` string, required
    - `name` string, required
    - `batteryLevel` number, required
    - `online` boolean, required
    - `provider` string, required
    - `imageUrl` string, nullable, required
    - `hasIssues` boolean

## Other responses

- `204` — The reservation does not have associated guest codes
- `400` — Bad request
- `401` — Unauthorized
- `404` — Can't find reservation, by provided ID

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)