Legacy format

This is an older feed format kept for reference. New integrations should use the current Real Estate docs: Single Office / Multi Office.

Fields description

Field	Required/Optional	Value	Description
jameslist_feed	Required	version="4.3"	Root node with version attribute
└ offices	Required		Wrapper for office details
└── office	Required	reference=""	Office details with unique reference
└─── name	Required	VarChar	Name of the office
└─── brokerage_license_id	Optional	VarChar	License number of the brokerage
└─── zip	Optional	VarChar	Zip code of the office
└─── country_code	Required	2-letter code	Country code according to ISO_3166-1_alpha-2
└─── country_subdivision	Optional	VarChar	State, province, or region
└─── city	Required	VarChar	City where the office is located
└─── address	Optional	VarChar	Address of the office
└─── phone1	Required	VarChar	Primary office phone number
└─── phone2	Optional	VarChar	Secondary office phone number
└─── fax	Optional	VarChar	Office fax number
└─── email	Optional	VarChar	Office email address
└─── description	Optional	Text	Description and details about the office
└─── external_url	Optional	VarChar	Office website URL
└─── office_logo_url	Optional	VarChar	URL of the office logo
└─── language_codes	Optional	VarChar	Three-letter languages code that office speaks. See See https://en.wikipedia.org/wiki/ISO_639-3
└─── linkedin	Optional	VarChar	Linkedin URL
└─── instagram	Optional	VarChar	Instagram URL
└─── facebook	Optional	VarChar	Facebook URL
└─── tiktok	Optional	VarChar	TikTok URL
agents	Optional		Wrapper for agent details
└ agent	Required	reference=""	Agent details with unique reference
└── office_reference	Required	VarChar	Reference to the office the agent is attached to
└─── first_name	Required	VarChar	First name of the agent
└─── last_name	Required	VarChar	Last name of the agent
└─── email	Required	VarChar	Agent’s email address
└─── phone1	Required	VarChar	Primary phone number for the agent
└─── phone2	Optional	VarChar	Secondary phone number for the agent
└─── fax	Optional	VarChar	Agent’s fax number
└─── profile_picture_url	Optional	VarChar	URL of the agent’s profile picture
└─── agent_license_id	Optional	VarChar	ID number of agent's license
└─── language_codes	Optional	VarChar	Three-letter languages code that agent speaks. See https://en.wikipedia.org/wiki/ISO_639-3
└─── linkedin	Optional	VarChar	Agent's Linkedin account URL
└─── instagram	Optional	VarChar	Agent's Instagram account URL
└─── facebook	Optional	VarChar	Agent's Facebook account URL
└─── tiktok	Optional	VarChar	Agent's TikTok account URL
└─── biography	Optional	VarChar	Agent's biography
listings	Required		Wrapper for property listings
└ listing	Required	reference=""	Property listing details with unique reference
└── mls_number	Optional	VarChar	MLS number if exists
└── preowned	Optional	yes/no	Whether the property is preowned
└── display_reference	Optional	VarChar	Display reference for the property
└── year_construction	Optional	Four digits	Year the property was constructed
└── price_on_request	Optional	yes/no	Indicates if the price is available on request
└── rental	Optional	yes/no	Specifies if the property is a rental
└── sale_price	Optional	Integer, currency=""	Sale price and currency code (ISO_4217)
└── rental_price_per_day	Optional	Integer, currency=""	Daily rental price and currency code
└── property_location	Required		Wrapper for property location details
└─── country	Required	VarChar	Country of the property
└─── country_subdivision	Required	VarChar	State or province of the property
└─── latitude	Optional	Float	Latitude of the property
└─── longitude	Optional	Float	Longitude of the property
└─── city	Required	VarChar	City where the property is located
└─── address	Optional	VarChar	Street address of the property
└─── zip	Required	VarChar	Postal/zip code of the property
└── title	Required	VarChar	Short description/title for the property
└── description	Required	Text	Full property description
└── property_type	Required	Enum	Type of property (e.g., Villa, House, Apartment)
└── bedrooms	Optional	Integer	Number of bedrooms in the property
└── bathrooms	Optional	Integer	Number of bathrooms in the property
└── floors	Optional	Integer	Number of floors in the property
└── living_area	Optional	Integer, unit="sqm/sqft"	Indoor living area
└── land_area	Optional	Integer, unit="sqm/sqft/ha/ac"	Outdoor land area
└── emission_rating	Optional	Text	Property emission rating (e.g., A, B, C)
└── consumption_rating	Optional	Text	Property emission rating (e.g., A, B, C)
└── amenities	Optional		Wrapper for amenities available
└─── pool	Optional	yes/no	Specifies if there is a pool
└─── ...	Optional	yes/no	See full list in Amenitites section
└── media	Optional		Wrapper for property image URLs
└─── image	Optional		Wrapper for property image URLs
└──── image_url	Required	VarChar	URL for a property picture JPEG, PNG or WEBP (up to 100 images)
└── video_url	Optional	VarChar	URL for a property video from supported sources (YouTube, Vimeo, Brightcove)
└── virtual_tour_url	Optional	VarChar	URL for a virtual tour (e.g., Matterport)
└── agent_reference	Required	VarChar	Reference to the agent assigned to the listing
└── office_reference	Required	VarChar	Reference to the office associated with the listing and agent
└── hide_address	Optional	yes/no	Specifies if the property address should be hidden on the listing (map, address)