---
title: "Retrieve a listing"
method: GET
path: "/listings/{id}"
tags: ["Listings"]
---

# Retrieve a listing

`GET /listings/{id}`

## Path parameters

- `id` string, required

## Query parameters

- `fields` string

## Response `200`

Listing object

- 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
            - `id` string
            - `livemode` boolean
            - `token_type` string
            - `stripe_publishable_key` string
            - `stripe_user_id` string
            - `scope` string
    - `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.

---

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