---
title: "Get an inventory item"
method: GET
path: "/inventory/{inventoryId}"
tags: ["Inventory"]
---

# Get an inventory item

`GET /inventory/{inventoryId}`

## Request

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

Get an inventory item by id

## Path parameters

- `inventoryId` string, required

## Headers

- `AgencyRef` string, required

## Response `200`

Returns the inventory item

- AltoInventoryApiModelsResponsesInventoryDetailItem
  - `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`: The inventory item 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)