---
title: "Get multiple inventory items"
method: GET
path: "/inventory/items"
tags: ["Inventory"]
---

# Get multiple inventory items

`GET /inventory/items`

## Request

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

Get inventory items for multiple inventory ids

## Query parameters

- `inventory-id` string[], required

## Headers

- `AgencyRef` string, required

## Response `200`

Returns the inventory items

- AltoServicesSDKModelsItemCollection1AltoInventoryApiModelsResponsesInventoryDetailItem
  - `totalCount` integer
  - `items` AltoInventoryApiModelsResponsesInventoryDetailItem[], nullable
    - `id` string, nullable
    - `branchId` string, nullable
    - `category` string, nullable
    - `recordType` string, nullable
    - `address` AltoInventoryApiModelsResponsesAddress
      - `subDwelling` string, nullable
      - `nameNo` string, nullable
      - `street` string, nullable
      - `locality` string, nullable
      - `town` string, nullable
      - `county` string, nullable
      - `postcode` string, nullable
      - `countryCode` string, nullable
    - `priceQualifier` string, nullable
    - `currency` string, nullable
    - `yearBuilt` integer, nullable
    - `newBuild` boolean, nullable
    - `floorAreaInSquareFeet` number, double, nullable
    - `landAreaInAcres` number, double, nullable
    - `price` number, double, nullable
    - `bedrooms` integer, nullable
    - `receptions` integer, nullable
    - `bathrooms` integer, nullable
    - `propertySubTypeId` integer
    - `propertyType` string, nullable
    - `status` string, nullable
    - `inventoryStatus` 'Unspecified' | 'Appraisal' | 'Available' | 'UnderOffer' | 'Completed' | 'Let' | 'LetAgreed' | 'LetMarketing' | 'Archived' | 'Suspended' | 'Withdrawn' | 'Instructed' | 'NotInstructed' | 'ExternallyLet' | 'UnderOfferMarketing' | 'UnderOfferAvailable' | 'Exchanged' | 'ExternallySold' | 'Reserved'
    - `archived` boolean
    - `isAtActiveStatus` boolean
    - `tenureId` integer
    - `tenure` string, nullable
    - `rentalFrequency` string, nullable
    - `tenancyType` 'Unspecified' | 'AssuredShortholdTenancy' | 'AssuredTenancy' | 'PublicSector' | 'HousingAssociation' | 'AssuredPeriodicTenancy'
    - `owners` AltoInventoryApiModelsResponsesOwner[], nullable
      - `ownerId` string, nullable
      - `contactId` integer
      - `name` AltoInventoryApiModelsResponsesName
        - `title` string, nullable
        - `forename` string, nullable
        - `surname` string, nullable
      - `phoneNumbers` AltoInventoryApiModelsResponsesPhone[], nullable
        - `preferenceOrder` integer
        - `type` string, nullable
        - `description` string, nullable
        - `number` string, nullable
      - `emailAddresses` AltoInventoryApiModelsResponsesEmailAddress[], nullable
        - `preferenceOrder` integer
        - `address` string, nullable
    - `taxBand` string, nullable
    - `taxBandExemptReason` string, nullable
    - `serviceCharge` string, nullable
    - `groundRent` string, nullable
    - `localAuthority` string, nullable
    - `leaseRemainingYears` integer, nullable
    - `leaseTerm` integer, nullable
    - `leaseEndDate` string, date-time, nullable
    - `groundRentReviewPeriod` number, double, nullable
    - `groundRentPercentageIncrease` number, double, nullable
    - `sharedOwnership` boolean, nullable
    - `sharedOwnershipPercentageShare` number, double, nullable
    - `sharedOwnershipRent` number, double, nullable
    - `sharedOwnershipRentFrequencyId` integer, nullable
    - `leaseNotes` string, nullable
    - `privateViewingNotes` string, nullable
    - `displayAddress` string, nullable
    - `hasAsbestos` boolean, nullable
    - `rentalDateAvailable` string, date-time, nullable
    - `groundRentFixedForTerm` boolean, nullable
    - `groundRentNotes` string, nullable
    - `serviceChargeNotes` string, nullable
    - `negotiator` AltoInventoryApiModelsSecurityUser
      - `id` integer
      - `name` string, nullable
      - `links` AltoApiMaterialHateoasLink[], nullable
        - `href` string, nullable
        - `rel` string, nullable
    - `negotiatorName` string, nullable
    - `instructionDate` string, date-time, nullable
    - `managementType` 'Unspecified' | 'NotManaged' | 'PartManaged' | 'Managed' | 'FullyManaged' | 'RentCollectionService' | 'LetOnly'
    - `maintenanceType` 'Unspecified' | 'MaintainedByLandlord' | 'MaintainedByUs'
    - `accessibilityRequirements` AltoInternalNtsAccessibilityRequirements
      - `accessibility` AltoInternalNtsAccessibility[], nullable
    - `broadband` AltoInternalNtsBroadband
      - `supply` AltoInternalNtsBroadbandSupply[], nullable
      - `speed` string, nullable
    - `buildingSafety` AltoInternalNtsBuildingSafety
      - `issue` string[], nullable
    - `construction` AltoInternalNtsConstruction
      - `material` string[], nullable
    - `coastalErosion` boolean, nullable
    - `electricity` AltoInternalNtsElectricity
      - `supply` AltoInternalNtsElectricitySupply[], nullable
    - `floodingRisks` AltoInternalNtsFloodingRisks
      - `sourcesOfFlooding` AltoInternalNtsFloodingSources
        - `source` AltoInternalNtsSourceOfFlooding[], nullable
      - `floodedWithinLast5Years` boolean, nullable
      - `floodDefensesPresent` boolean, nullable
    - `heating` AltoInternalNtsHeating
      - `source` AltoInternalNtsHeatingSource[], nullable
    - `knownPlanningConsiderations` string, nullable
    - `miningRisks` AltoInternalNtsMiningRisks
      - `coalfields` boolean, nullable
      - `otherMiningActivities` boolean, nullable
    - `mobileCoverage` string, nullable
    - `parking` AltoInternalNtsParking
      - `parkingType` AltoInternalNtsParkingType[], nullable
    - `restrictions` AltoInternalNtsRestrictions
      - `conservationArea` boolean, nullable
      - `leaseRestrictions` boolean, nullable
      - `listedBuilding` boolean, nullable
      - `permittedDevelopment` boolean, nullable
      - `realBurdens` boolean, nullable
      - `holidayHomeRental` boolean, nullable
      - `restrictiveCovenant` boolean, nullable
      - `businessFromProperty` boolean, nullable
      - `propertySubletting` boolean, nullable
      - `treePreservationOrder` boolean, nullable
      - `other` boolean, nullable
    - `rightsAndEasements` AltoInternalNtsRightsAndEasements
      - `rightOfWayPublic` boolean, nullable
      - `rightOfWayPrivate` boolean, nullable
      - `registeredEasementsHmlr` boolean, nullable
      - `servitudes` boolean, nullable
      - `sharedDriveway` boolean, nullable
      - `loftAccess` boolean, nullable
      - `drainAccess` boolean, nullable
      - `other` boolean, nullable
    - `sewerage` AltoInternalNtsSewerage
      - `supply` AltoInternalNtsSewerageSupply[], nullable
    - `water` AltoInternalNtsWater
      - `supply` AltoInternalNtsWaterSupply[], nullable
    - `epc` AltoInventoryApiModelsResponsesEpc: Energy Performance Certificate
      - `energyEfficiencyRatingCurrent` integer, nullable: Current energy efficiency rating
      - `energyEfficiencyRatingPotential` integer, nullable: Potential energy efficiency rating
      - `exempt` boolean: Whether listing has an EPC Exemption
      - `exemptionReason` string, nullable: Reason for an EPC Exemption
    - `uprn` string, nullable
    - `createdDate` string, date-time, nullable
    - `modifiedDate` string, date-time, nullable
    - `propertyManager` AltoInventoryApiModelsSecurityUser
      - `id` integer
      - `name` string, nullable
      - `links` AltoApiMaterialHateoasLink[], nullable
        - `href` string, nullable
        - `rel` string, nullable

## Other responses

- `400`: When the request does not contain the expected information
- `401`: When access has not been granted
- `404`: 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)