---
title: "Get property information from UPRN including structured address parts"
method: GET
path: "/uprn"
---

# Get property information from UPRN including structured address parts

`GET /uprn`

## Request

- Base URL: `https://api.propertydata.co.uk`
- URL: `https://api.propertydata.co.uk/uprn`
- Auth: HTTP bearer

Costs 10 credits per call. Coverage: England, Wales and Scotland only, not Northern Ireland.

## Query parameters

- `uprn` string, required

## Response `200`

Successful response with address, addressParts (secondary, primary, street, town, district, postcode), lat, lng, description, useClass, optional transaction/EPC/council tax data, and registeredLeases (each with a lease_id and the registered term plus parsed term_years, term_start_date, term_end_date and calculated years_remaining)

- object
  - `status` string
  - `api_calls_cost` integer
  - `uprn` string
  - `data` object
    - `certNum` string
    - `address` string
    - `lat` string
    - `lng` string
    - `description` string
    - `useClass` string
    - `lastSoldAmount` integer
    - `lastSoldDate` string
    - `lastSoldTransactionId` string
    - `estimate` integer
    - `inflatorEstimate` integer
    - `sqfEstimate` integer
    - `inflatorWeight` number
    - `sqfWeight` number
    - `internalArea` integer
    - `energyScore` string
    - `energyScoreNumerical` integer
    - `habitableRooms` integer
    - `estimatedBedrooms` integer
    - `propertyType` string
    - `tenure` string
    - `constructionAgeBand` string
    - `mainFuel` string
    - `floorLevel` string
    - `taxBand` string
    - `taxRate` string
    - `transactions` object[]
      - `date` string
      - `amount` integer
      - `id` string
    - `addressParts` object
      - `secondary` unknown
      - `primary` string
      - `street` string
      - `town` string
      - `district` string
      - `postcode` string
    - `registeredLeases` object[]
      - `lease_id` string
      - `term` string
      - `term_years` integer
      - `term_start_date` string
      - `term_end_date` string
      - `years_remaining` integer
      - `date_of_lease` string
      - `price_paid` string
      - `registerPropertyDescription` string
      - `associatedPropertyDescription` string
      - `region` string
      - `county` string
      - `alienation_clause` string
  - `process_time` string: Server processing time in seconds

## Other responses

- `4XX`: Error response. Common codes: X02 missing key (400), X03 invalid key (422), X04 credit limit exceeded (403), X06/X07 missing or invalid location input (400/422), X08 insufficient data for location (404), X13 free trial limit exceeded (403), X14 rate limited (429), X20 server busy, retry after 60 seconds (503).

---

[API](https://skmtc.dev/propertydata/apis/propertydata-api.md) · [All operations](https://skmtc.dev/propertydata/apis/propertydata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/propertydata/apis/propertydata-api/revisions/38ab011f2f4c?raw)