---
title: "Get a property listing"
method: GET
path: "/listing/property/{propertyId}"
tags: ["Listing"]
---

# Get a property listing

`GET /listing/property/{propertyId}`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/listing/property/{propertyId}`
- Auth: `appAuth` (a scheme the document does not define)

Get a property listing by property id

## Path parameters

- `propertyId` integer, required

## Headers

- `AgencyRef` string, required

## Response `200`

Returns the property listing

- ListingResponse
  - `propertyId` integer
  - `market` string, nullable
  - `displayAddress` string, nullable
  - `priceQualifier` string, nullable
  - `currency` string, nullable
  - `price` number, double, nullable
  - `bedrooms` integer, nullable
  - `bathrooms` integer, nullable
  - `receptions` integer, nullable
  - `floorAreaInSquareFeet` number, double, nullable
  - `landAreaInAcres` number, double, nullable
  - `propertyType` string, nullable
  - `taxBand` string, nullable
  - `taxBandExemptReason` string, nullable
  - `summary` string, nullable
  - `includeLeadInOutText` boolean
  - `leadInText` string, nullable
  - `leadOutText` string, nullable
  - `publicViewingNotes` string, nullable
  - `epcCurrent` integer, nullable
  - `epcPotential` integer, nullable
  - `epc` ListingEpcResponse
    - `energyEfficiencyRatingCurrent` integer, nullable: Current energy efficiency rating
    - `energyEfficiencyRatingPotential` integer, nullable: Potential energy efficiency rating
    - `energyEfficiencyBandCurrent` string, nullable: Current energy efficiency band
    - `energyEfficiencyBandPotential` string, nullable: Potential energy efficiency band
    - `exempt` boolean: Whether listing has an EPC Exemption
    - `exemptionReason` string, nullable: Reason for an EPC Exemption
  - `rental` ListingRentalResponse
    - `frequency` string, nullable
    - `availableFrom` string, date-time, nullable
    - `deposit` number, double, nullable
    - `furnishing` string, nullable
    - `lettingType` string, nullable
    - `children` boolean: Whether children are allowed
    - `pets` boolean: Whether pets are allowed
    - `smokers` boolean: Whether smokers are allowed
    - `termLengthMonths` integer, nullable: Term Length (months)
  - `sale` ListingSaleResponse
    - `tenure` string, nullable
    - `newHome` boolean
  - `isLeasehold` boolean
  - `lease` ListingLeaseResponse
    - `yearsRemaining` integer, nullable
    - `endDate` string, date-time, nullable
    - `sharedOwnership` boolean, nullable
    - `sharedOwnershipPercentageShare` number, double, nullable
    - `sharedOwnershipRent` number, double, nullable
    - `sharedOwnershipFrequency` string, nullable
    - `serviceCharge` number, double, nullable
    - `annualGroundRent` number, double, nullable
    - `groundRentReviewPeriod` number, double, nullable
    - `groundRentPercentageIncrease` number, double, nullable
  - `auction` ListingAuctionResponse
    - `auction` boolean, nullable: Whether the property is for auction.
    - `auctionClosingDate` string, date-time, nullable: The closing date of the auction.
    - `auctionReserve` number, double, nullable: The reserve amount for the auction.
  - `bullets` ListingBulletResponse[], nullable
    - `orderIndex` integer
    - `content` string, nullable
  - `rooms` ListingRoomResponse[], nullable
    - `id` integer
    - `orderIndex` integer
    - `name` string, nullable
    - `size` string, nullable
    - `sizeMetric` string, nullable
    - `sizeImperial` string, nullable
    - `description` string, nullable
    - `roomRecordType` 'Unspecified' | 'Room' | 'Paragraph'
  - `age` string, nullable
  - `yearBuilt` integer, nullable
  - `newBuild` boolean, nullable
  - `parkingTotal` integer, nullable
  - `uprn` string, nullable
  - `mapping` ListingMappingResponse
    - `mapLocation` ListingMapLocationResponse
      - `latitude` number, double, nullable
      - `longitude` number, double, nullable
    - `streetView` ListingStreetViewResponse
      - `latitude` number, double, nullable
      - `longitude` number, double, nullable
      - `heading` number, double, nullable
      - `pitch` number, double, nullable
      - `zoom` integer, nullable
  - `createdDate` string, date-time, nullable
  - `modifiedDate` string, date-time, nullable

## Other responses

- `400`: When the request does not contain the expected information
- `401`: When access has not been granted
- `404`: The property listing was not found

---

[API](https://skmtc.dev/alto/apis/alto-api.md) - [All operations](https://skmtc.dev/alto/apis/alto-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alto/apis/alto-api/revisions/1b729d9b15a8?raw)