---
title: "Retrieve an owner reservation"
method: GET
path: "/owners-reservations/{id}"
tags: ["Owners Reservations"]
---

# Retrieve an owner reservation

`GET /owners-reservations/{id}`

This allows you to obtain details about a specific owner's reservation.

## Path parameters

- `id` string, required

## Response `200`

Reservation response

- object
  - `_id` string — Unique Id
  - `status` string
  - `source` string
  - `accountId` string — Unique Id
  - `listingId` string — Unique Id
  - `checkIn` string
  - `checkOut` string
  - `note` string
  - `__v` number
  - `createdAt` string
  - `checkInDateLocalized` string
  - `checkOutDateLocalized` string
  - `plannedDeparture` string
  - `plannedArrival` string
  - `lastUpdatedAt` string
  - `listing` object
    - `_id` string — String (ObjectId)
    - `accountId` string — String (ObjectId)
    - `createdAt` string
    - `integrations` object[]
      - `_id` string — Unique Id
      - `airbnb2` object — Only if platform is airbnb
        - `credentials` object
          - `code` string
          - `expiresAt` integer
          - `accessToken` string
          - `refreshToken` string
          - `lastForceRefresh` string — date
        - `forwardEmails` object
          - `all` boolean
          - `emails` string[]
        - `createdAt` string — date
      - `forwardEmails` object
        - `all` boolean
        - `emails` string[]
      - `active` boolean — Status of connection
      - `platform` string
      - `listings` object[]
      - `complexes` object[]
      - `nickname` string
      - `channelId` string
      - `activatedAt` string — Date
      - `disconnectedAt` string — Date
      - `proxyEmail` string
      - `incomingEmail` string
      - `externalAccountId` string
      - `id` integer — External ID
      - `companyName` string
      - `fetchRequests` object[]
        - `fetchAllListings` boolean
        - `externalListingIds` string[]
        - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED' | 'TIMEOUT'
        - `createTime` string — Date
        - `updateTime` string — Date
        - `finishedTime` string — Date
      - `status` 'NOT_CONNECTED' | 'CONNECTING' | 'CONNECTED' | 'FAILED' | 'TIMEOUT' | 'DISCONNECTED' | 'PENDING'
      - `migration` object
        - `status` 'IN_PROGRESS' | 'COMPLETED' | 'FAILED'
        - `createTime` string — Date
        - `updateTime` string — Date
        - `finishedTime` string — Date
        - `steps` object[]
        - `discrepancyStepExecuted` boolean
        - `discrepancyResolution` 'GUESTY' | 'AIRBNB'
        - `listingQuantityDiscrepancyStepExecuted` boolean
        - `error` object
          - `at` string — Date
          - `code` string
          - `message` string
          - `raw` object
        - `notes` string
        - `isRollingBack` boolean
      - `userId` string
      - `accountId` string — Owner
      - `tripAdvisor` object — TripAdvisor details
      - `homeaway2` object — Homeaway details
      - `bookingCom` object — BookingCom details
        - `legalEntityId` string
      - `createdAt` string — Date
      - `missingStep` string
      - `steps` object[]
        - `type` string
        - `status` 'COMPLETED' | 'IN_PROGRESS'
        - `createTime` string — Date
        - `updateTime` string — Date
      - `newIntegrationBackup` object
      - `threadIdsMigrated` boolean
      - `isDeleted` boolean
      - `deletedAt` string — Date
    - `isVirtual` boolean
    - `nickname` string
    - `tags` string[]
    - `isListed` boolean
    - `title` string
    - `propertyType` string
    - `roomType` string
    - `bedType` string
    - `accommodates` number
    - `bedrooms` number
    - `areaSquareFeet` number
    - `address` object
      - `full` string — full address
      - `lng` number
      - `lat` number
      - `street` string
      - `city` string
      - `country` string
    - `publishedAddress` object
      - `full` string — full address
      - `lng` number
      - `lat` number
      - `street` string
      - `city` string
      - `country` string
    - `timezone` string
    - `defaultCheckInTime` string
    - `defaultCheckOutTime` string
    - `cleaning` object
      - `defaultCleaningTime` string
      - `instructions` string
    - `cleaningStatus` object
      - `value` 'clean' | 'waitingForInspection' | 'dirty' | 'unknown'
      - `updatedAt` string
    - `picture` object
      - `regular` string
      - `thumbnail` string
      - `large` string
      - `caption` string
      - `height` number
      - `original` string
      - `size` number
      - `width` number
    - `pictures` object[]
      - `regular` string
      - `thumbnail` string
      - `large` string
      - `caption` string
      - `height` number
      - `original` string
      - `size` number
      - `width` number
    - `amenities` string[]
    - `amenitiesNotIncluded` string[]
    - `terms` object
      - `minNights` number
      - `maxNights` number
      - `cancellation` string
    - `prices` object
      - `guestsIncludedInRegularFee` number
      - `extraPersonFee` number
      - `basePrice` number
      - `basePriceUSD` number
      - `monthlyPriceFactor` number — Accepted values are float values between 0 and 1. In order to have 10% discount set 0.90. To have 5% discount set 0.95.
      - `weeklyPriceFactor` number — Accepted values are float values between 0 and 1. In order to have 10% discount set 0.90. To have 5% discount set 0.95.
      - `weekendBasePrice` number
      - `securityDepositFee` number
      - `currency` string
      - `cleaningFee` number
    - `netIncomeFormula` string
    - `commissionFormula` string
    - `commissionTaxPrecentage` string
    - `pms` object
      - `active` boolean
      - `automation` object
        - `autoList` object
          - `active` boolean
          - `config` string[]
      - `inbox` object
        - `customSignature` string
      - `cleaningStatus` object
        - `value` 'clean' | 'waitingForInspection' | 'dirty' | 'unknown'
        - `updatedAt` string
      - `paymentProcessing` object
        - `active` boolean
        - `paymentProviders` object
          - `stripe` object
            - `active` boolean
            - `status` string
            - `accountName` string
            - `defaultCurrency` string
            - `syncedAt` string, date
            - `payload` object
              - …
      - `autoPayments` object
        - `policy` unknown[]
          - unknown
    - `receptionistsService` object
      - `receptionDesk` object
        - `ittt` unknown[]
          - unknown
      - `screening` object
        - `checklist` unknown[]
          - unknown
      - `contactPersonUserId` string
    - `active` boolean
    - `customFields` object
    - `calendarRules` object
    - `publicDescription` object
    - `privateDescription` object
    - `markups` object
    - `isTest` boolean — Marks the listing as a test property. Test property titles must include the 'Test_' prefix. Only SINGLE-type listings can be selected.
  - `owner` object
    - `ownersPortalSettings` object — The OPSettings object
      - `bookedNights` boolean
      - `revenue` boolean
      - `accommodationFare` boolean
      - `netAccommodationFare` boolean
      - `netRentalIncome` boolean
      - `guestsReports` boolean
      - `guestsReportsViewId` string
      - `occupancy` boolean
      - `avgNightlyRate` boolean
      - `revPal` boolean
      - `hostPayout` boolean
      - `nightlyRate` boolean
      - `minNights` boolean
      - `bookingSource` boolean
      - `showReservationTooltips` boolean
      - `showInternalNotesForBlocks` boolean
      - `showNotesForCoOwnerReservations` boolean
      - `showReservedReservations` boolean
      - `showHelpCenter` boolean
      - `showOwnerStatements` boolean
      - `allowReservations` boolean
      - `allowReservationsUnavailableDates` boolean
      - `showGuestFullName` boolean
      - `showGuestEmail` boolean
      - `showGuestPhone` boolean
      - `showOverallGuestRating` boolean
      - `showGuestReviews` boolean
      - `inquiriesCount` boolean
      - `averageBookingValue` boolean
      - `averageGuestStay` boolean
      - `ownerReservationRevenueLoss` boolean
      - `ownerReservationBookedNights` boolean
    - `listings` string[] — Listings Id
    - `_id` string — Unique Id
    - `locale` string — Localization
    - `active` boolean
    - `allowReservations` boolean — Deprecated. Use ownersPortalSettings.allowReservations
    - `showReservationTooltips` boolean — Deprecated. Use ownersPortalSettings.showReservationTooltips
    - `businessInformation` object
      - `businessType` object
        - `type` string
        - `other` string
      - `address` object
        - `street` string
        - `city` string
        - `state` string
        - `zipcode` string
        - `country` string
        - `full` string
      - `vatIdentificationNumber` string
      - `vatRate` number — Range between 0 - 100
      - `ownerCommission` number — Range between 0 - 100
    - `birthday` string — Date
    - `anniversary` string — Date
    - `workingCapital` number — Deprecated
    - `firstName` string
    - `lastName` string
    - `fullName` string
    - `email` string — Primary email address
    - `address` string
    - `personalAddress` object
      - `street` string
      - `city` string
      - `state` string
      - `zipcode` string
      - `country` string
      - `full` string
    - `phone` string — Primary phone number
    - `picture` object
      - `thumbnail` string
      - `regular` string
      - `large` string
    - `notes` string
    - `createdAt` string — date ISO
  - `nightsCount` number
  - `id` string

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Unhandled exception. Something went wrong on server.

---

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