# Retrieve guests for specified room stay

Fetch a list of all guests associated with a specific room stay. This endpoint is useful for retrieving detailed information about guests staying in a room. If the specified room stay ID does not exist, a 404 Not Found error will be returned. In case of an unexpected system error, a 500 Internal Server Error will be triggered.

Endpoint: GET /api/v3/roomStays/{id}/guests
Version: 3.0.9
Security: OAuth2

## Path parameters:

  - `id` (integer, required)
    The unique identifier of the room stay to retrieve guest stays for

## Response 200 fields (application/json):

  - `content` (array)

  - `content.id` (integer)

  - `content.firstName` (string, required)

  - `content.middleNames` (string)

  - `content.lastName` (string, required)

  - `content.jobTitle` (string)

  - `content.department` (string)

  - `content.preferences` (string)

  - `content.status` (string)
    Enum: "ACTIVE", "INACTIVE", "BANNED", "ARCHIVED", "VIP", "WAITLIST", "REMOVED"

  - `content.marketingOptOut` (boolean)
    Marketing opt-out status of the contact

  - `content.contactSalesAccount` (object)
    Sales account associated with the contact

  - `content.contactSalesAccount.id` (integer)
    Unique identifier of the finance account

  - `content.contactSalesAccount.accountCode` (string)
    Account code of the finance account

  - `content.contactSalesAccount.contact` (object, required)

  - `content.contactSalesAccount.contact.id` (integer)
    Unique identifier of the contact

  - `content.contactSalesAccount.contact.firstName` (string)
    First name of the contact

  - `content.contactSalesAccount.contact.lastName` (string)
    Last name of the contact

  - `content.contactSalesAccount.company` (object)
    Company summary associated with the finance account

  - `content.contactSalesAccount.company.id` (integer)
    Unique identifier of the company

  - `content.contactSalesAccount.company.companyName` (string)
    Name of the company

  - `content.contactSalesAccount.externalId` (string)
    External identifier of the finance account

  - `content.contactSalesAccount.exportedDate` (string)
    Date when the finance account was exported

  - `content.contactSalesAccount.exportStatus` (string)
    Export status of the finance account
    Enum: "SKIPPED", "CREATED", "PENDING", "SENT", "EXPORTED", "FAILED", "IMPORTED"

  - `content.title` (string)
    Title of the contact
    Enum: "MR", "MISS", "MS", "MRS"

  - `content.gender` (string)
    Gender of the contact
    Enum: "MALE", "FEMALE", "OTHER"

  - `content.referrer` (object)

  - `content.referrer.id` (integer)
    Unique identifier of the referrer

  - `content.referrer.code` (string)
    Code of the referrer

  - `content.referrer.name` (string)
    Name of the referrer

  - `content.industry` (object)

  - `content.industry.id` (integer)
    Unique identifier of the industry

  - `content.industry.name` (string)
    Name of the industry

  - `content.marketSegment` (object)

  - `content.marketSegment.id` (integer)
    Unique identifier of the market segment

  - `content.marketSegment.name` (string, required)
    Name of the market segment

  - `content.nationality` (object)
    Nationality of the contact

  - `content.nationality.id` (integer)
    ID of the nationality

  - `content.nationality.name` (string)
    Name of the nationality

  - `content.nationality.isoCode` (integer)
    ISO code of the nationality

  - `content.nationality.sortOrder` (integer)
    Sort order of the nationality

  - `content.nationality.countryCodeAlpha2` (string)
    Country code in Alpha-2 format

  - `content.primaryContactAddress` (object, required)
    Data Transfer Object representing a contact's address

  - `content.primaryContactAddress.id` (integer)
    Unique identifier of the address

  - `content.primaryContactAddress.addressLine1` (string)
    First line of the address

  - `content.primaryContactAddress.addressLine2` (string)
    Second line of the address

  - `content.primaryContactAddress.addressLine3` (string)
    Third line of the address

  - `content.primaryContactAddress.city` (string)
    City of the address

  - `content.primaryContactAddress.postCode` (string)
    Postal code of the address

  - `content.primaryContactAddress.country` (object)
    Data Transfer Object representing a Country entity in the Property Management System (PMS).

  - `content.primaryContactAddress.country.id` (integer)
    Unique identifier of the country

  - `content.primaryContactAddress.country.name` (string, required)
    Name of the country

  - `content.primaryContactAddress.country.sortOrder` (integer, required)
    Sort order of the country

  - `content.primaryContactAddress.country.countryCodeAlpha2` (string, required)
    Alpha-2 country code

  - `content.primaryContactAddress.country.countryCodeAlpha3` (string, required)
    Alpha-3 country code

  - `content.primaryContactAddress.country.countryCodeNumeric` (string, required)
    Numeric country code

  - `content.primaryContactAddress.nickname` (string)
    Nickname of the contact address

  - `content.primaryContactAddress.primary` (boolean)
    Indicates if this is the primary address

  - `content.primaryContactEmailAddress` (object, required)
    Primary email address of the contact

  - `content.primaryContactEmailAddress.id` (integer)
    Unique identifier of the email address
    Example: 1

  - `content.primaryContactEmailAddress.email` (string, required)
    Email address
    Example: "info@resharmonics.com"

  - `content.primaryContactEmailAddress.nickname` (string)
    Nickname of the contact

  - `content.primaryContactEmailAddress.primary` (boolean)
    Indicates if this is the primary email address

  - `content.primaryContactTelephoneNumber` (object, required)
    Primary telephone number of the contact

  - `content.primaryContactTelephoneNumber.number` (string, required)

  - `content.primaryContactTelephoneNumber.primary` (boolean)
    Indicates if this is the primary telephone number

  - `content.preferredContactMethod` (string)
    Preferred contact method of the contact
    Enum: "TELEPHONE", "EMAIL", "MAIL"

  - `content.type` (string)
    Type of the contact
    Enum: "BOOKER", "GUEST"

  - `content.source` (string)
    Source of the contact
    Enum: "OFFLINE_SOURCE", "ONLINE_ENQUIRY_FORM", "ONLINE_BOOKING", "DIRECT_SALE", "SALES_CHANNEL"

  - `content.idCheck` (boolean)
    ID check status of the contact

  - `content.companyName` (string)
    Company name associated with the contact

  - `content.lifecycleStage` (string)
    Lifecycle stage of the contact
    Enum: "LEAD", "QUALIFIED", "DISQUALIFIED", "OPPORTUNITY", "CUSTOMER"

  - `content.lastBookingRole` (string)
    Last booking role of the contact
    Enum: "NONE", "BOOKER", "GUEST", "GUEST_BOOKER"

  - `content.uuid` (string)
    UUID of the contact

  - `content.password` (string)
    Password of the contact

  - `content.saltoIdentifier` (string)
    Salto identifier of the contact

  - `content.saltoAssignedTagId` (string)
    Salto assigned tag ID of the contact

  - `content.cognitoId` (string)
    Cognito ID of the contact

  - `content.passportNumber` (string)
    Passport number of the contact

  - `content.saltoRegistrationStatus` (string)
    Salto registration status of the contact
    Enum: "UNKNOWN", "NOT_INVITED", "INVITED", "REGISTERED"

  - `content.saltoKeysLastUpdated` (string)
    Last updated time of Salto keys

  - `content.keyCardCode` (string)
    Key card code of the contact

  - `content.identityConfirmedDate` (string)
    Date when the identity was confirmed

  - `content.identityConfirmedReference` (string)
    Reference for the identity confirmation

  - `content.creditCheckOk` (boolean)
    Credit check status of the contact

  - `content.creditCheckDate` (string)
    Date of the credit check

  - `content.socialSecurityNumber` (string)
    Social security number of the contact

  - `content.dateOfBirth` (string)

  - `page` (object)

  - `page.size` (integer)

  - `page.totalElements` (integer)

  - `page.totalPages` (integer)