Skip to main content

​
Overview

Listing and building responses include photo keys: 32-character hex hashes that identify images. Borough also exposes a public photo proxy at /v1/photos/{key} so clients can fetch supported image sizes through the Borough domain when they want a stable first-party URL.

​
Borough photo proxy

Supported sizes:
  • large_800_400 (default)
  • medium_500_250
The photo proxy returns the upstream image bytes with long-lived cache headers. Invalid keys return 400; missing images return 404.

​
URL format

​
Available sizes

​
Example

Given a photo key ed2987594843debc8e828fef155dbb6d:

​
Where keys appear

  • ListingSummary.leadPhotoKey: Primary listing photo
  • ListingDetail.floorPlanKey: Floor plan image (if available)