---
title: "Get multiple property listings"
method: GET
path: "/listing/property/items"
tags: ["Listing"]
---

# Get multiple property listings

`GET /listing/property/items`

## Request

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

Get property listings for multiple property ids

## Query parameters

- `property-id` string[]

## Headers

- `AgencyRef` string, required

## Response `200`

Returns the property listings

- ListingResponseItemCollection
  - `totalCount` integer
  - `items` ListingResponse[], nullable
    - `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

---

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