@vepler/sdk 2.33.0 → 2.38.2

package/src/sdk/models/operations/getlistingbysource.ts

@@ -4,25 +4,26 @@
 
 import * as z from "zod/v3";
 import { safeParse } from "../../../lib/schemas.js";
-import { ClosedEnum } from "../../types/enums.js";
+import * as openEnums from "../../types/enums.js";
+import { ClosedEnum, OpenEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
 /**
- * Force aggregation from multiple sources
+ * Merge listing data from multiple sources into a single enriched record (default: false). When true, the response combines details from all available provider feeds for this property. When false, returns only the primary source record.
  */
 export const ForceAggregate = {
   True: "true",
   False: "false",
 } as const;
 /**
- * Force aggregation from multiple sources
+ * Merge listing data from multiple sources into a single enriched record (default: false). When true, the response combines details from all available provider feeds for this property. When false, returns only the primary source record.
  */
 export type ForceAggregate = ClosedEnum<typeof ForceAggregate>;
 
 export type GetListingBySourceRequest = {
   /**
-   * Force aggregation from multiple sources
+   * Merge listing data from multiple sources into a single enriched record (default: false). When true, the response combines details from all available provider feeds for this property. When false, returns only the primary source record.
    */
   forceAggregate?: ForceAggregate | undefined;
   /**
@@ -36,11 +37,590 @@ export type GetListingBySourceRequest = {
 };
 
 /**
- * Listing successfully retrieved
+ * Structured postal address for the listed property. Fields are parsed from the original listing data and may be incomplete depending on what the agent provided. The postcode is always present and serves as the primary geographic key.
+ */
+export type GetListingBySourceAddress = {
+  /**
+   * City, town, or village name as used by Royal Mail for postal addressing.
+   */
+  city?: string | undefined;
+  /**
+   * ISO 3166-1 alpha-2 country code. Defaults to 'GB' for Great Britain. Currently only UK properties are supported.
+   */
+  country: string;
+  /**
+   * Local district, borough, or neighbourhood within the city (e.g. 'Westminster', 'Shoreditch', 'Didsbury').
+   */
+  district?: string | undefined;
+  /**
+   * Inward code — the second part of the UK postcode after the space (e.g. '1AA', '4QE'). Combined with outcode forms the full postcode.
+   */
+  incode?: string | undefined;
+  /**
+   * The raw, unstructured address string exactly as received from the source data feed, before any parsing or normalisation. Useful for display purposes or debugging address-matching issues.
+   */
+  originalAddress: string;
+  /**
+   * Outward code — the first part of the UK postcode before the space (e.g. 'SW1A', 'M1', 'EC2'). Useful for area-level grouping and search.
+   */
+  outcode?: string | undefined;
+  /**
+   * Full UK postcode in standard Royal Mail format (e.g. 'SW1A 1AA'). Always present and is the primary geographic identifier used for location matching.
+   */
+  postcode: string;
+  /**
+   * Building or house number, including any suffix (e.g. '12A', '3-5'). May be absent for named properties or new-build plots.
+   */
+  propertyNumber?: string | undefined;
+  /**
+   * County or administrative region (e.g. 'Greater London', 'West Yorkshire', 'Surrey').
+   */
+  region?: string | undefined;
+  /**
+   * Street or road name, without the property number. May include thoroughfare type (e.g. 'High Street', 'Park Lane', 'The Crescent').
+   */
+  street?: string | undefined;
+};
+
+/**
+ * Contact and identification details for the estate agent marketing this property. All agent data is publicly available information sourced from property portal listings. Null if agent details were not available in the source feed.
+ */
+export type GetListingBySourceAgent = {
+  /**
+   * Postal address of the estate agency branch office, as a single formatted string.
+   */
+  address?: string | undefined;
+  /**
+   * Opaque identifier for the agency within the source provider's system. Can be used to group listings across all branches of the same agency.
+   */
+  agencyId?: string | undefined;
+  /**
+   * Trading name of the parent estate agency company (e.g. 'Savills', 'Foxtons', 'Purplebricks'). This is the top-level brand that owns one or more branches.
+   */
+  agencyName?: string | undefined;
+  /**
+   * Opaque identifier for the individual agent within the source provider's system. Format varies by provider.
+   */
+  agentId?: string | undefined;
+  /**
+   * Name of the individual estate agent or negotiator handling this listing. This is publicly available information from property portals.
+   */
+  agentName?: string | undefined;
+  /**
+   * Opaque identifier for the branch within the source provider's system. Can be used to group listings by branch.
+   */
+  branchId?: string | undefined;
+  /**
+   * Name of the specific estate agency branch marketing this property (e.g. 'Kensington Office', 'Manchester City Centre'). A single agency may have multiple branches.
+   */
+  branchName?: string | undefined;
+  /**
+   * Primary contact email address for the branch. This is publicly listed contact information from property portals.
+   */
+  email?: string | undefined;
+  /**
+   * Additional email addresses for the branch or individual agents. These are publicly available from property portal listings.
+   */
+  emails?: Array<string> | undefined;
+  /**
+   * Primary contact telephone number for the branch, typically a UK landline or local rate number. This is publicly listed contact information from property portals. Format varies (e.g. '020 1234 5678', '02012345678').
+   */
+  phone?: string | undefined;
+  /**
+   * Additional contact telephone numbers for the branch (e.g. mobile numbers, out-of-hours lines). These are publicly available from property portal listings.
+   */
+  phones?: Array<string> | undefined;
+  /**
+   * UK postcode of the estate agency branch office.
+   */
+  postcode?: string | undefined;
+  /**
+   * URL of the agency's website. May point to the branch-specific page or the agency homepage.
+   */
+  website?: string | undefined;
+};
+
+/**
+ * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+ */
+export const GetListingBySourceListingsType = {
+  Standard: "standard",
+  Floorplan: "floorplan",
+  Epc: "epc",
+  Brochure: "brochure",
+} as const;
+/**
+ * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+ */
+export type GetListingBySourceListingsType = OpenEnum<
+  typeof GetListingBySourceListingsType
+>;
+
+/**
+ * A single image asset associated with a property listing. Images are sourced from property portal CDNs and are publicly accessible.
+ */
+export type GetListingBySourceBrochureImages = {
+  /**
+   * Human-readable caption describing the image content, as provided by the listing agent (e.g. 'Master bedroom', 'Rear garden', 'Kitchen/diner').
+   */
+  caption?: string | undefined;
+  /**
+   * Zero-based display order for the image within its type group. The first image (order 0) is typically the hero/primary image used for thumbnails and search results.
+   */
+  order?: number | undefined;
+  /**
+   * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+   */
+  type?: GetListingBySourceListingsType | undefined;
+  /**
+   * Absolute URL to the image file. Images are typically served from provider CDNs (e.g. media.rightmove.co.uk, lid.zoocdn.com). URLs may include query parameters for resizing. These are publicly accessible and do not require authentication.
+   */
+  url: string;
+};
+
+/**
+ * Broad property category. 'residential': dwellings including houses, flats, bungalows, and maisonettes. 'commercial': non-residential premises such as offices, retail units, warehouses, and mixed-use buildings.
+ */
+export const GetListingBySourceCategory = {
+  Residential: "residential",
+  Commercial: "commercial",
+} as const;
+/**
+ * Broad property category. 'residential': dwellings including houses, flats, bungalows, and maisonettes. 'commercial': non-residential premises such as offices, retail units, warehouses, and mixed-use buildings.
+ */
+export type GetListingBySourceCategory = OpenEnum<
+  typeof GetListingBySourceCategory
+>;
+
+/**
+ * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+ */
+export const GetListingBySourceListingsResponseType = {
+  Standard: "standard",
+  Floorplan: "floorplan",
+  Epc: "epc",
+  Brochure: "brochure",
+} as const;
+/**
+ * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+ */
+export type GetListingBySourceListingsResponseType = OpenEnum<
+  typeof GetListingBySourceListingsResponseType
+>;
+
+/**
+ * A single image asset associated with a property listing. Images are sourced from property portal CDNs and are publicly accessible.
+ */
+export type GetListingBySourceEnergyRatingImages = {
+  /**
+   * Human-readable caption describing the image content, as provided by the listing agent (e.g. 'Master bedroom', 'Rear garden', 'Kitchen/diner').
+   */
+  caption?: string | undefined;
+  /**
+   * Zero-based display order for the image within its type group. The first image (order 0) is typically the hero/primary image used for thumbnails and search results.
+   */
+  order?: number | undefined;
+  /**
+   * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+   */
+  type?: GetListingBySourceListingsResponseType | undefined;
+  /**
+   * Absolute URL to the image file. Images are typically served from provider CDNs (e.g. media.rightmove.co.uk, lid.zoocdn.com). URLs may include query parameters for resizing. These are publicly accessible and do not require authentication.
+   */
+  url: string;
+};
+
+/**
+ * A structured key-value property feature extracted from the listing. Features capture specific property attributes such as tenure, EPC rating, parking arrangements, and amenities.
+ */
+export type GetListingBySourceFeatures = {
+  /**
+   * Normalised feature identifier key. Common values include: 'parking', 'garden', 'garage', 'central_heating', 'double_glazing', 'epc_rating', 'council_tax_band', 'tenure', 'chain_free', 'conservatory', 'fireplace'. The set of available feature IDs varies by data provider and is not strictly enumerated — treat as a free-form key.
+   */
+  featureId: string;
+  /**
+   * Human-readable feature value as stated by the agent. For boolean-style features this may be 'Yes'/'No'; for categorical features it contains the specific value (e.g. 'Band D' for council_tax_band, 'C' for epc_rating, 'Freehold' for tenure).
+   */
+  value: string;
+};
+
+/**
+ * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+ */
+export const GetListingBySourceListingsResponse200Type = {
+  Standard: "standard",
+  Floorplan: "floorplan",
+  Epc: "epc",
+  Brochure: "brochure",
+} as const;
+/**
+ * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+ */
+export type GetListingBySourceListingsResponse200Type = OpenEnum<
+  typeof GetListingBySourceListingsResponse200Type
+>;
+
+/**
+ * A single image asset associated with a property listing. Images are sourced from property portal CDNs and are publicly accessible.
+ */
+export type GetListingBySourceFloorPlanImages = {
+  /**
+   * Human-readable caption describing the image content, as provided by the listing agent (e.g. 'Master bedroom', 'Rear garden', 'Kitchen/diner').
+   */
+  caption?: string | undefined;
+  /**
+   * Zero-based display order for the image within its type group. The first image (order 0) is typically the hero/primary image used for thumbnails and search results.
+   */
+  order?: number | undefined;
+  /**
+   * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+   */
+  type?: GetListingBySourceListingsResponse200Type | undefined;
+  /**
+   * Absolute URL to the image file. Images are typically served from provider CDNs (e.g. media.rightmove.co.uk, lid.zoocdn.com). URLs may include query parameters for resizing. These are publicly accessible and do not require authentication.
+   */
+  url: string;
+};
+
+/**
+ * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+ */
+export const GetListingBySourceListingsResponse200ApplicationJSONType = {
+  Standard: "standard",
+  Floorplan: "floorplan",
+  Epc: "epc",
+  Brochure: "brochure",
+} as const;
+/**
+ * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+ */
+export type GetListingBySourceListingsResponse200ApplicationJSONType = OpenEnum<
+  typeof GetListingBySourceListingsResponse200ApplicationJSONType
+>;
+
+/**
+ * A single image asset associated with a property listing. Images are sourced from property portal CDNs and are publicly accessible.
+ */
+export type GetListingBySourceImages = {
+  /**
+   * Human-readable caption describing the image content, as provided by the listing agent (e.g. 'Master bedroom', 'Rear garden', 'Kitchen/diner').
+   */
+  caption?: string | undefined;
+  /**
+   * Zero-based display order for the image within its type group. The first image (order 0) is typically the hero/primary image used for thumbnails and search results.
+   */
+  order?: number | undefined;
+  /**
+   * Classification of the image asset. 'standard': property photography (exterior, rooms, garden, etc.). 'floorplan': annotated floor plan diagram with room dimensions. 'epc': Energy Performance Certificate chart or graph image. 'brochure': marketing brochure page scan or PDF-derived image.
+   */
+  type?: GetListingBySourceListingsResponse200ApplicationJSONType | undefined;
+  /**
+   * Absolute URL to the image file. Images are typically served from provider CDNs (e.g. media.rightmove.co.uk, lid.zoocdn.com). URLs may include query parameters for resizing. These are publicly accessible and do not require authentication.
+   */
+  url: string;
+};
+
+/**
+ * The narrative text body. When a string: a single block of prose (may contain HTML line breaks or plain text). When an array: an ordered list of paragraphs or bullet points, each element being one distinct point. Null if the narrative section exists in the source feed but its content was empty or could not be extracted.
+ */
+export type GetListingBySourceContent = string | Array<string> | any;
+
+/**
+ * Type of narrative content. summary: brief overview of the property (1-2 sentences). description: full marketing description. features: bullet-pointed key selling points. location: description of the surrounding area, transport links, and amenities. other: additional narrative that does not fit other categories.
+ */
+export const GetListingBySourceListingsResponse200ApplicationJSONResponseBodyType =
+  {
+    Summary: "summary",
+    Description: "description",
+    Features: "features",
+    Location: "location",
+    Other: "other",
+  } as const;
+/**
+ * Type of narrative content. summary: brief overview of the property (1-2 sentences). description: full marketing description. features: bullet-pointed key selling points. location: description of the surrounding area, transport links, and amenities. other: additional narrative that does not fit other categories.
+ */
+export type GetListingBySourceListingsResponse200ApplicationJSONResponseBodyType =
+  OpenEnum<
+    typeof GetListingBySourceListingsResponse200ApplicationJSONResponseBodyType
+  >;
+
+/**
+ * A block of descriptive marketing copy associated with the listing. Narratives are authored by estate agents and extracted from property portal feeds. Content may contain marketing language and should not be treated as verified fact.
+ */
+export type GetListingBySourceNarratives = {
+  /**
+   * The narrative text body. When a string: a single block of prose (may contain HTML line breaks or plain text). When an array: an ordered list of paragraphs or bullet points, each element being one distinct point. Null if the narrative section exists in the source feed but its content was empty or could not be extracted.
+   */
+  content?: string | Array<string> | any | null | undefined;
+  /**
+   * Type of narrative content. summary: brief overview of the property (1-2 sentences). description: full marketing description. features: bullet-pointed key selling points. location: description of the surrounding area, transport links, and amenities. other: additional narrative that does not fit other categories.
+   */
+  type: GetListingBySourceListingsResponse200ApplicationJSONResponseBodyType;
+};
+
+/**
+ * Object type discriminator. Always 'listing' for single listing responses. Follows the Stripe-style convention for typed API responses.
+ */
+export const GetListingBySourceObject = {
+  Listing: "listing",
+} as const;
+/**
+ * Object type discriminator. Always 'listing' for single listing responses. Follows the Stripe-style convention for typed API responses.
+ */
+export type GetListingBySourceObject = ClosedEnum<
+  typeof GetListingBySourceObject
+>;
+
+/**
+ * Direction of a price revision. 'increase': the asking price or rent was raised. 'decrease': the asking price or rent was reduced (commonly signals motivated seller or market correction). 'nochange': a price event was recorded but the value remained unchanged (e.g. relisting at the same price).
+ */
+export const GetListingBySourceDirection = {
+  Increase: "increase",
+  Decrease: "decrease",
+  Nochange: "nochange",
+} as const;
+/**
+ * Direction of a price revision. 'increase': the asking price or rent was raised. 'decrease': the asking price or rent was reduced (commonly signals motivated seller or market correction). 'nochange': a price event was recorded but the value remained unchanged (e.g. relisting at the same price).
+ */
+export type GetListingBySourceDirection = OpenEnum<
+  typeof GetListingBySourceDirection
+>;
+
+/**
+ * A single price revision event in the listing's history. Price changes are tracked chronologically and can be used to analyse market trends, seller motivation, and time-on-market patterns. All monetary values are in GBP pence.
+ */
+export type GetListingBySourcePriceHistory = {
+  /**
+   * Absolute price change in GBP pence (new price minus old price). Negative values indicate a price reduction; positive values indicate an increase.
+   */
+  amount?: number | undefined;
+  /**
+   * ISO 8601 date when the price change was observed or published on the portal.
+   */
+  date: Date;
+  /**
+   * Direction of a price revision. 'increase': the asking price or rent was raised. 'decrease': the asking price or rent was reduced (commonly signals motivated seller or market correction). 'nochange': a price event was recorded but the value remained unchanged (e.g. relisting at the same price).
+   */
+  direction?: GetListingBySourceDirection | undefined;
+  /**
+   * The previous listing price before the change, in GBP pence. Divide by 100 to convert to pounds sterling. May be absent for the initial listing event.
+   */
+  oldPrice?: number | undefined;
+  /**
+   * Price change expressed as a percentage of the old price. Negative values indicate a reduction (e.g. -3.85 means a 3.85% reduction). Positive values indicate an increase.
+   */
+  percent?: number | undefined;
+  /**
+   * The new listing price after the change, in GBP pence. Divide by 100 to convert to pounds sterling. For sales listings this is the revised asking price; for rental listings this is the revised monthly rent (per calendar month).
+   */
+  price: number;
+};
+
+/**
+ * GeoJSON geometry type
+ */
+export const GetListingBySourceListingsResponse200ApplicationJSONResponseBodySpatialType =
+  {
+    Point: "Point",
+  } as const;
+/**
+ * GeoJSON geometry type
+ */
+export type GetListingBySourceListingsResponse200ApplicationJSONResponseBodySpatialType =
+  ClosedEnum<
+    typeof GetListingBySourceListingsResponse200ApplicationJSONResponseBodySpatialType
+  >;
+
+/**
+ * GeoJSON Point geometry representing the property's geographic location. Coordinates are in WGS84 (EPSG:4326) as [longitude, latitude]. May be null if the property could not be geocoded. Accuracy varies — some coordinates represent postcode centroids rather than exact property positions.
+ */
+export type GetListingBySourceGeoJSONPoint = {
+  /**
+   * Coordinate pair [longitude, latitude]
+   */
+  coordinates: Array<number>;
+  /**
+   * GeoJSON geometry type
+   */
+  type:
+    GetListingBySourceListingsResponse200ApplicationJSONResponseBodySpatialType;
+};
+
+/**
+ * Current status of the listing. 'live': actively marketed on one or more property portals. 'archived': listing was taken off market by the agent but retained for historical analysis (e.g. price comparisons). 'removed': listing has been permanently withdrawn or the source feed no longer includes it. Typical lifecycle: live -> archived -> removed.
+ */
+export const GetListingBySourceStatus = {
+  Live: "live",
+  Archived: "archived",
+  Removed: "removed",
+} as const;
+/**
+ * Current status of the listing. 'live': actively marketed on one or more property portals. 'archived': listing was taken off market by the agent but retained for historical analysis (e.g. price comparisons). 'removed': listing has been permanently withdrawn or the source feed no longer includes it. Typical lifecycle: live -> archived -> removed.
+ */
+export type GetListingBySourceStatus = OpenEnum<
+  typeof GetListingBySourceStatus
+>;
+
+/**
+ * Market type for the listing. 'sale': property is listed for purchase — the price field represents the asking price in GBP pence. 'rent': property is listed for tenancy — the price field represents the monthly rental amount in GBP pence (per calendar month).
+ */
+export const GetListingBySourceType = {
+  Sale: "sale",
+  Rent: "rent",
+} as const;
+/**
+ * Market type for the listing. 'sale': property is listed for purchase — the price field represents the asking price in GBP pence. 'rent': property is listed for tenancy — the price field represents the monthly rental amount in GBP pence (per calendar month).
+ */
+export type GetListingBySourceType = OpenEnum<typeof GetListingBySourceType>;
+
+/**
+ * Response containing a single property listing with full details.
  */
 export type GetListingBySourceResponseBody = {
-  result?: any | null | undefined;
-  success: boolean;
+  /**
+   * Structured postal address for the listed property. Fields are parsed from the original listing data and may be incomplete depending on what the agent provided. The postcode is always present and serves as the primary geographic key.
+   */
+  address: GetListingBySourceAddress;
+  /**
+   * Contact and identification details for the estate agent marketing this property. All agent data is publicly available information sourced from property portal listings. Null if agent details were not available in the source feed.
+   */
+  agent?: GetListingBySourceAgent | null | undefined;
+  /**
+   * Number of bathrooms as advertised by the agent, including en-suites and shower rooms. Null if not specified in the listing.
+   */
+  baths?: number | null | undefined;
+  /**
+   * Number of bedrooms as advertised by the agent. Null if the listing does not specify bedroom count (common for studios or commercial properties). A value of 0 typically indicates a studio flat.
+   */
+  beds?: number | null | undefined;
+  /**
+   * Marketing brochure images, typically scanned pages or PDF-derived images from the agent's printed particulars. Empty array if no brochure material is available.
+   */
+  brochureImages?: Array<GetListingBySourceBrochureImages> | undefined;
+  /**
+   * Broad property category. 'residential': dwellings including houses, flats, bungalows, and maisonettes. 'commercial': non-residential premises such as offices, retail units, warehouses, and mixed-use buildings.
+   */
+  category: GetListingBySourceCategory;
+  /**
+   * ISO 8601 datetime when this listing record was first created in our system. This may differ from publishedDate if the listing was retrospectively imported.
+   */
+  createdAt?: Date | undefined;
+  /**
+   * ISO 4217 currency code for all monetary values in this listing. Currently always 'GBP' (British Pound Sterling). All price fields are denominated in the smallest currency unit (pence).
+   */
+  currency: string;
+  /**
+   * Pre-formatted address string suitable for display in search results and listing cards. This is the agent's preferred public-facing address and may be intentionally vague (e.g. omitting house number for privacy). Use the structured 'address' object for programmatic access.
+   */
+  displayAddress?: string | undefined;
+  /**
+   * Energy Performance Certificate (EPC) chart images. In England and Wales, an EPC is legally required when a property is marketed for sale or rent. Typically contains one image showing the energy efficiency rating (A-G scale). Empty array if no EPC image is available.
+   */
+  energyRatingImages?: Array<GetListingBySourceEnergyRatingImages> | undefined;
+  /**
+   * Structured key-value property features extracted from the listing (e.g. tenure, EPC rating, council tax band, parking type). Null if the source data did not include any structured features. See ListingFeature for the full set of common feature IDs.
+   */
+  features?: Array<GetListingBySourceFeatures> | null | undefined;
+  /**
+   * Floor plan diagram images showing room layouts and approximate dimensions. May contain multiple images for multi-storey properties (one per floor). Empty array if no floor plans are available.
+   */
+  floorPlanImages?: Array<GetListingBySourceFloorPlanImages> | undefined;
+  /**
+   * System-generated UUID that uniquely identifies this listing record. Stable across updates — the same listing retains its ID even when price or status changes.
+   */
+  id: string;
+  /**
+   * Property photography images (exterior shots, room photos, garden views, etc.). Ordered by the agent's preferred display sequence. Images are hosted on provider CDNs and are publicly accessible. Empty array if no photographs are available.
+   */
+  images?: Array<GetListingBySourceImages> | undefined;
+  /**
+   * Whether this property is being sold via auction rather than private treaty. Auction properties typically require exchange of contracts on the fall of the hammer and completion within 28 days.
+   */
+  isAuction?: boolean | undefined;
+  /**
+   * Whether this is a newly constructed property that has not previously been occupied. New-build properties may be available off-plan (before construction is complete) and often qualify for government schemes such as Help to Buy.
+   */
+  isNewBuild?: boolean | undefined;
+  /**
+   * Whether this is an age-restricted retirement or sheltered housing property. Retirement properties typically have minimum age requirements (usually 55+) and may include communal facilities.
+   */
+  isRetirement?: boolean | undefined;
+  /**
+   * Whether this listing is offered under a shared ownership scheme, where the buyer purchases a percentage share (typically 25-75%) and pays rent on the remainder to a housing association. Common in affordable housing programmes.
+   */
+  isSharedOwnership?: boolean | undefined;
+  /**
+   * The listing's unique reference within the source provider's system. Combined with 'provider', this forms a globally unique source reference. Typically a numeric or alphanumeric ID assigned by the portal.
+   */
+  key: string;
+  /**
+   * WGS84 latitude of the property location in decimal degrees. May represent an approximate position (e.g. postcode centroid) rather than the exact building location.
+   */
+  lat?: number | undefined;
+  /**
+   * WGS84 longitude of the property location in decimal degrees. May represent an approximate position (e.g. postcode centroid) rather than the exact building location.
+   */
+  lng?: number | undefined;
+  /**
+   * Internal location identifier used for geographic grouping, typically derived from the property's postcode (spaces removed, e.g. 'SW1A1AA'). Used to link listings to location-level analytics and nearby properties.
+   */
+  locationId?: string | null | undefined;
+  /**
+   * Marketing description text blocks authored by the estate agent, categorised by type (summary, full description, features list, location guide). Null if no descriptive content was available in the source feed.
+   */
+  narratives?: Array<GetListingBySourceNarratives> | null | undefined;
+  /**
+   * Object type discriminator. Always 'listing' for single listing responses. Follows the Stripe-style convention for typed API responses.
+   */
+  object: GetListingBySourceObject;
+  /**
+   * Current listing price in GBP pence. Divide by 100 to convert to pounds sterling. For sale listings: the asking price (e.g. 50000000 = £500,000). For rental listings: the monthly rent per calendar month (e.g. 150000 = £1,500 pcm). Always reflects the most recent price after any revisions.
+   */
+  price: number;
+  /**
+   * Chronological history of price changes since the listing was first published. Each entry records a revision event with the old and new prices. Useful for tracking asking-price reductions and market sentiment. Ordered from earliest to most recent change.
+   */
+  priceHistory?: Array<GetListingBySourcePriceHistory> | undefined;
+  /**
+   * Primary property type classification. Common values for residential include: 'detached', 'semi-detached', 'terraced', 'flat', 'bungalow', 'maisonette', 'end_terrace', 'cottage', 'park_home'. For commercial: 'office', 'retail', 'warehouse', 'industrial', 'land'. Values are normalised from provider-specific taxonomies but may occasionally contain non-standard entries.
+   */
+  propertyType: string;
+  /**
+   * Identifier for the data provider or property portal that supplied this listing (e.g. a feed aggregator or portal). Used alongside 'key' to form a unique composite reference to the source record.
+   */
+  provider: string;
+  /**
+   * ISO 8601 datetime when the listing was first published or appeared on the source portal. This date remains unchanged even if the listing is subsequently updated.
+   */
+  publishedDate: Date;
+  /**
+   * Number of reception rooms (living rooms, dining rooms, sitting rooms) as advertised by the agent. This is a UK-specific property metric. Null if not specified in the listing.
+   */
+  receptions?: number | null | undefined;
+  /**
+   * ISO 8601 datetime when the listing was removed from the source portal, or null if the listing is still active. A removed date typically indicates the property has been sold, let, or withdrawn from the market.
+   */
+  removedDate?: Date | null | undefined;
+  /**
+   * GeoJSON Point geometry representing the property's geographic location. Coordinates are in WGS84 (EPSG:4326) as [longitude, latitude]. May be null if the property could not be geocoded. Accuracy varies — some coordinates represent postcode centroids rather than exact property positions.
+   */
+  spatial?: GetListingBySourceGeoJSONPoint | null | undefined;
+  /**
+   * Current status of the listing. 'live': actively marketed on one or more property portals. 'archived': listing was taken off market by the agent but retained for historical analysis (e.g. price comparisons). 'removed': listing has been permanently withdrawn or the source feed no longer includes it. Typical lifecycle: live -> archived -> removed.
+   */
+  status: GetListingBySourceStatus;
+  /**
+   * Secondary property type qualifier providing additional architectural or style context (e.g. 'Victorian', 'Georgian', 'Purpose Built', 'Conversion', 'Studio'). Null when the source data does not provide a sub-classification.
+   */
+  subPropertyType?: string | null | undefined;
+  /**
+   * Market type for the listing. 'sale': property is listed for purchase — the price field represents the asking price in GBP pence. 'rent': property is listed for tenancy — the price field represents the monthly rental amount in GBP pence (per calendar month).
+   */
+  type: GetListingBySourceType;
+  /**
+   * ISO 8601 datetime when this listing record was last modified in our system. Updated whenever any field changes, including price revisions, status transitions, or image additions.
+   */
+  updatedAt?: Date | undefined;
 };
 
 /** @internal */
@@ -74,14 +654,405 @@ export function getListingBySourceRequestToJSON(
   );
 }
 
+/** @internal */
+export const GetListingBySourceAddress$inboundSchema: z.ZodType<
+  GetListingBySourceAddress,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  city: z.string().optional(),
+  country: z.string().default("GB"),
+  district: z.string().optional(),
+  incode: z.string().optional(),
+  originalAddress: z.string(),
+  outcode: z.string().optional(),
+  postcode: z.string(),
+  propertyNumber: z.string().optional(),
+  region: z.string().optional(),
+  street: z.string().optional(),
+});
+
+export function getListingBySourceAddressFromJSON(
+  jsonString: string,
+): SafeParseResult<GetListingBySourceAddress, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetListingBySourceAddress$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetListingBySourceAddress' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetListingBySourceAgent$inboundSchema: z.ZodType<
+  GetListingBySourceAgent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  address: z.string().optional(),
+  agencyId: z.string().optional(),
+  agencyName: z.string().optional(),
+  agentId: z.string().optional(),
+  agentName: z.string().optional(),
+  branchId: z.string().optional(),
+  branchName: z.string().optional(),
+  email: z.string().optional(),
+  emails: z.array(z.string()).optional(),
+  phone: z.string().optional(),
+  phones: z.array(z.string()).optional(),
+  postcode: z.string().optional(),
+  website: z.string().optional(),
+});
+
+export function getListingBySourceAgentFromJSON(
+  jsonString: string,
+): SafeParseResult<GetListingBySourceAgent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetListingBySourceAgent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetListingBySourceAgent' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetListingBySourceListingsType$inboundSchema: z.ZodType<
+  GetListingBySourceListingsType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(GetListingBySourceListingsType);
+
+/** @internal */
+export const GetListingBySourceBrochureImages$inboundSchema: z.ZodType<
+  GetListingBySourceBrochureImages,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  caption: z.string().optional(),
+  order: z.number().optional(),
+  type: GetListingBySourceListingsType$inboundSchema.optional(),
+  url: z.string(),
+});
+
+export function getListingBySourceBrochureImagesFromJSON(
+  jsonString: string,
+): SafeParseResult<GetListingBySourceBrochureImages, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetListingBySourceBrochureImages$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetListingBySourceBrochureImages' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetListingBySourceCategory$inboundSchema: z.ZodType<
+  GetListingBySourceCategory,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(GetListingBySourceCategory);
+
+/** @internal */
+export const GetListingBySourceListingsResponseType$inboundSchema: z.ZodType<
+  GetListingBySourceListingsResponseType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(GetListingBySourceListingsResponseType);
+
+/** @internal */
+export const GetListingBySourceEnergyRatingImages$inboundSchema: z.ZodType<
+  GetListingBySourceEnergyRatingImages,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  caption: z.string().optional(),
+  order: z.number().optional(),
+  type: GetListingBySourceListingsResponseType$inboundSchema.optional(),
+  url: z.string(),
+});
+
+export function getListingBySourceEnergyRatingImagesFromJSON(
+  jsonString: string,
+): SafeParseResult<GetListingBySourceEnergyRatingImages, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      GetListingBySourceEnergyRatingImages$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetListingBySourceEnergyRatingImages' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetListingBySourceFeatures$inboundSchema: z.ZodType<
+  GetListingBySourceFeatures,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  featureId: z.string(),
+  value: z.string(),
+});
+
+export function getListingBySourceFeaturesFromJSON(
+  jsonString: string,
+): SafeParseResult<GetListingBySourceFeatures, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetListingBySourceFeatures$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetListingBySourceFeatures' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetListingBySourceListingsResponse200Type$inboundSchema: z.ZodType<
+  GetListingBySourceListingsResponse200Type,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(GetListingBySourceListingsResponse200Type);
+
+/** @internal */
+export const GetListingBySourceFloorPlanImages$inboundSchema: z.ZodType<
+  GetListingBySourceFloorPlanImages,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  caption: z.string().optional(),
+  order: z.number().optional(),
+  type: GetListingBySourceListingsResponse200Type$inboundSchema.optional(),
+  url: z.string(),
+});
+
+export function getListingBySourceFloorPlanImagesFromJSON(
+  jsonString: string,
+): SafeParseResult<GetListingBySourceFloorPlanImages, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetListingBySourceFloorPlanImages$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetListingBySourceFloorPlanImages' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetListingBySourceListingsResponse200ApplicationJSONType$inboundSchema:
+  z.ZodType<
+    GetListingBySourceListingsResponse200ApplicationJSONType,
+    z.ZodTypeDef,
+    unknown
+  > = openEnums.inboundSchema(
+    GetListingBySourceListingsResponse200ApplicationJSONType,
+  );
+
+/** @internal */
+export const GetListingBySourceImages$inboundSchema: z.ZodType<
+  GetListingBySourceImages,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  caption: z.string().optional(),
+  order: z.number().optional(),
+  type: GetListingBySourceListingsResponse200ApplicationJSONType$inboundSchema
+    .optional(),
+  url: z.string(),
+});
+
+export function getListingBySourceImagesFromJSON(
+  jsonString: string,
+): SafeParseResult<GetListingBySourceImages, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetListingBySourceImages$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetListingBySourceImages' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetListingBySourceContent$inboundSchema: z.ZodType<
+  GetListingBySourceContent,
+  z.ZodTypeDef,
+  unknown
+> = z.union([z.string(), z.array(z.string()), z.any()]);
+
+export function getListingBySourceContentFromJSON(
+  jsonString: string,
+): SafeParseResult<GetListingBySourceContent, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetListingBySourceContent$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetListingBySourceContent' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetListingBySourceListingsResponse200ApplicationJSONResponseBodyType$inboundSchema:
+  z.ZodType<
+    GetListingBySourceListingsResponse200ApplicationJSONResponseBodyType,
+    z.ZodTypeDef,
+    unknown
+  > = openEnums.inboundSchema(
+    GetListingBySourceListingsResponse200ApplicationJSONResponseBodyType,
+  );
+
+/** @internal */
+export const GetListingBySourceNarratives$inboundSchema: z.ZodType<
+  GetListingBySourceNarratives,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  content: z.nullable(z.union([z.string(), z.array(z.string()), z.any()]))
+    .optional(),
+  type:
+    GetListingBySourceListingsResponse200ApplicationJSONResponseBodyType$inboundSchema,
+});
+
+export function getListingBySourceNarrativesFromJSON(
+  jsonString: string,
+): SafeParseResult<GetListingBySourceNarratives, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetListingBySourceNarratives$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetListingBySourceNarratives' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetListingBySourceObject$inboundSchema: z.ZodNativeEnum<
+  typeof GetListingBySourceObject
+> = z.nativeEnum(GetListingBySourceObject);
+
+/** @internal */
+export const GetListingBySourceDirection$inboundSchema: z.ZodType<
+  GetListingBySourceDirection,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(GetListingBySourceDirection);
+
+/** @internal */
+export const GetListingBySourcePriceHistory$inboundSchema: z.ZodType<
+  GetListingBySourcePriceHistory,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  amount: z.number().optional(),
+  date: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  direction: GetListingBySourceDirection$inboundSchema.optional(),
+  oldPrice: z.number().optional(),
+  percent: z.number().optional(),
+  price: z.number(),
+});
+
+export function getListingBySourcePriceHistoryFromJSON(
+  jsonString: string,
+): SafeParseResult<GetListingBySourcePriceHistory, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetListingBySourcePriceHistory$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetListingBySourcePriceHistory' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetListingBySourceListingsResponse200ApplicationJSONResponseBodySpatialType$inboundSchema:
+  z.ZodNativeEnum<
+    typeof GetListingBySourceListingsResponse200ApplicationJSONResponseBodySpatialType
+  > = z.nativeEnum(
+    GetListingBySourceListingsResponse200ApplicationJSONResponseBodySpatialType,
+  );
+
+/** @internal */
+export const GetListingBySourceGeoJSONPoint$inboundSchema: z.ZodType<
+  GetListingBySourceGeoJSONPoint,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  coordinates: z.array(z.number()),
+  type:
+    GetListingBySourceListingsResponse200ApplicationJSONResponseBodySpatialType$inboundSchema,
+});
+
+export function getListingBySourceGeoJSONPointFromJSON(
+  jsonString: string,
+): SafeParseResult<GetListingBySourceGeoJSONPoint, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetListingBySourceGeoJSONPoint$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetListingBySourceGeoJSONPoint' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetListingBySourceStatus$inboundSchema: z.ZodType<
+  GetListingBySourceStatus,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(GetListingBySourceStatus);
+
+/** @internal */
+export const GetListingBySourceType$inboundSchema: z.ZodType<
+  GetListingBySourceType,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(GetListingBySourceType);
+
 /** @internal */
 export const GetListingBySourceResponseBody$inboundSchema: z.ZodType<
   GetListingBySourceResponseBody,
   z.ZodTypeDef,
   unknown
 > = z.object({
-  result: z.nullable(z.any()).optional(),
-  success: z.boolean(),
+  address: z.lazy(() => GetListingBySourceAddress$inboundSchema),
+  agent: z.nullable(z.lazy(() => GetListingBySourceAgent$inboundSchema))
+    .optional(),
+  baths: z.nullable(z.number()).optional(),
+  beds: z.nullable(z.number()).optional(),
+  brochureImages: z.array(
+    z.lazy(() => GetListingBySourceBrochureImages$inboundSchema),
+  ).optional(),
+  category: GetListingBySourceCategory$inboundSchema,
+  createdAt: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  currency: z.string().default("GBP"),
+  displayAddress: z.string().optional(),
+  energyRatingImages: z.array(
+    z.lazy(() => GetListingBySourceEnergyRatingImages$inboundSchema),
+  ).optional(),
+  features: z.nullable(
+    z.array(z.lazy(() => GetListingBySourceFeatures$inboundSchema)),
+  ).optional(),
+  floorPlanImages: z.array(
+    z.lazy(() => GetListingBySourceFloorPlanImages$inboundSchema),
+  ).optional(),
+  id: z.string(),
+  images: z.array(z.lazy(() => GetListingBySourceImages$inboundSchema))
+    .optional(),
+  isAuction: z.boolean().optional(),
+  isNewBuild: z.boolean().optional(),
+  isRetirement: z.boolean().optional(),
+  isSharedOwnership: z.boolean().optional(),
+  key: z.string(),
+  lat: z.number().optional(),
+  lng: z.number().optional(),
+  locationId: z.nullable(z.string()).optional(),
+  narratives: z.nullable(
+    z.array(z.lazy(() => GetListingBySourceNarratives$inboundSchema)),
+  ).optional(),
+  object: GetListingBySourceObject$inboundSchema,
+  price: z.number(),
+  priceHistory: z.array(
+    z.lazy(() => GetListingBySourcePriceHistory$inboundSchema),
+  ).optional(),
+  propertyType: z.string(),
+  provider: z.string(),
+  publishedDate: z.string().datetime({ offset: true }).transform(v =>
+    new Date(v)
+  ),
+  receptions: z.nullable(z.number()).optional(),
+  removedDate: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ).optional(),
+  spatial: z.nullable(
+    z.lazy(() => GetListingBySourceGeoJSONPoint$inboundSchema),
+  ).optional(),
+  status: GetListingBySourceStatus$inboundSchema,
+  subPropertyType: z.nullable(z.string()).optional(),
+  type: GetListingBySourceType$inboundSchema,
+  updatedAt: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
 });
 
 export function getListingBySourceResponseBodyFromJSON(