---
title: "Get guest by id"
method: GET
path: "/guests-crud/{guestId}"
tags: ["Guests"]
---

# Get guest by id

`GET /guests-crud/{guestId}`

Get guest by id

## Path parameters

- `guestId` string, required

## Query parameters

- `fields` string, required

## Response `200`

The guest has been successfully pulled.

- object
  - `_id` string, required
  - `firstName` string, required
  - `lastName` string, required
  - `fullName` string
  - `hometown` string
  - `createdAt` string, date-time
  - `address` object
  - `picture` object — A link to guest’s picture in different sizes
  - `email` string — The main contact email of the guest
  - `emails` string[] — List of additional emails of the guest
  - `phone` string — The main contact phone number
  - `phones` string[] — List of additional phone numbers of the guest
  - `notes` string — Attention notes about the guest, describing important pieces of information about the guest, to review for all reservations (e.g. “Requires accessibility equipment”)
  - `tags` string[] — Tags for describing the guest at a glance + show the enum for the field to show the allowed options
  - `goodToKnowNotes` string — “Good to know” notes about the guest. Notes to help capture facts about the guest that will help the team to personalize the guest’s stays (e.g. “Big football fan”)
  - `preferredLanguage` string
  - `birthday` string, date-time
  - `gender` string
  - `maritalStatus` string
  - `dietaryPreferences` string[] — You can pick one of the predefined options, or create a new one for your account
  - `allergies` string[] — You can pick one of the predefined options, or create a new one for your account
  - `interests` string[]
  - `pronouns` string
  - `otaLinks` object[] — A link to the guest’s profile on an OTA
    - `type` 'airbnb'
    - `url` 'https://www.airbnb.com' — The url must include “https://” prefix
  - `kids` number
  - `passportNumber` string
  - `identityNumber` string
  - `nationality` string
  - `contactType` string
  - `airbnb2` object
  - `rentalsUnited` object
  - `bookingCom` object
  - `homeAway` object
  - `tripAdvisor` object
  - `policy` object
  - `returningGuest` boolean, required

## Other responses

- `401` — Can not pull guest, unauthorized
- `404` — Guest not found

---

[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)