RE/MAX Europe Listings API

The RE/MAX Europe Listings API is used in conjunction with the RE/MAX EU Datahub application to add, update, retrieve and delete property listing data and listing images across RE/MAX European regions. It exposes listings, listing images, listing entry logs, regions, offices and agents, plus unauthenticated-looking convenience reads for listing countries and cities by country. Writes go through a queue with deferred validation. Like the Datahub API it is a proprietary REST schema with no RESO Data Dictionary alignment, no OData $metadata and no UPI. Authentication is OAuth 2.0 with the token supplied as an access_token query parameter. The only public documentation RE/MAX Europe publishes is for the STAGING environment, whose endpoints run on a third-party host (bwscloud.tech); no production base URL is published.

Postman Collection

re-max-eu-listings-api.postman_collection.json Raw ↑
{"info":{"_postman_id":"8927220b-2631-4058-9ccf-cf2eaaee4173","name":"RE/MAX EU - Listings API - Staging","description":"<html><head></head><body><p>The Listings API is used in conjunction with the RE/MAX EU Datahub application to add, update and get listing data.</p>\n<p>Users can interact with the API using REST (GET, POST, PUT, DELETE) requests to the API URL.</p>\n<h2 id=\"oauth-20-authentication\">OAuth 2.0 Authentication</h2>\n<p>The user makes a request for an API token using the OAuth 2.0 server. The access_key is then added as the <strong>access_token</strong> query parameter.</p>\n<h2 id=\"data-return-format\">Data Return Format</h2>\n<p>In general, all requests have the following reponse format:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n  \"success\": false | true,\n  \"message\": &lt;Descriptive message&gt;,\n  \"result\": {},// any data is returned here\n  \"error\": { // if success is false, an error will be returned here\n    \"error\": \"Invalid region action requested: the user does not have access to this region\"\n  },\n  \"status\": { \n    \"code\": 403, // http response code\n    \"message\": \"Forbidden\" // http response message\n  }\n}\n\n</code></pre>\n<p>The only exceptions are:</p>\n<ul>\n<li><p>get listings</p>\n</li>\n<li><p>get listing detail</p>\n</li>\n<li><p>get listing countries</p>\n</li>\n<li><p>get listing cities by country</p>\n</li>\n</ul>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"29687718","collectionId":"8927220b-2631-4058-9ccf-cf2eaaee4173","publishedId":"2sA3drJF17","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-05-21T08:20:53.000Z"},"item":[{"name":"Calls with Datahub IDs","item":[{"name":"Add Listing","id":"c1b53238-462c-46ff-ad5d-6dea16d61193","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"listingId\" : \"test-12345\",  // ID from your system for later reference\n    \"status\": \"Active\",\n    \"agentUniqueId\": \"CH2-P100002\",\n    \"title\": \"Sample Title 2\",\n    \"description\": \"Sample Description 2\",\n    \"roomDescription\" : \"Sample room description\",\n    \"bathroomDescription\" : \"Sample bathroom description\",\n    \"bedroomDescription\" : \"Sample bedroom description\",\n    \"kitchenDescription\" : \"Sample kitchen description\",\n    \"address\": \"1234 Sample Street\",\n    \"streetBlock\": \"Block 4\",\n    \"zipcode\": \"12345\",\n    \"regionId\": \"FI1\",\n    \"officeId\":\"FI1-F1079993\",\n    \"city\": \"Friesneksor\",\n    \"country\": \"Finland\",\n    \"offerType\": \"Sale\",\n    \"listingType\": \"Commercial\",\n    \"buildingSize\": 1000.00,\n    \"propertySize\": 2000.00,\n    \"sizeUnit\": \"m2\",\n    \"virtualTour\": \"No\",\n    \"noOfRooms\": 5,\n    \"noOfBathrooms\": 2,\n    \"noOfBedrooms\" : 2,\n    \"constructionYear\": 2000,\n    \"energyRating\": \"A\",\n    \"floorNumber\": \"1\",\n    \"elevatorAccess\": \"Yes\",\n    \"outsideAreaType\": \"Garden\",\n    \"outsideAreaSize\": \"Large\",\n    \"listingCurrency\": \"EUR\",\n    \"listingPrice\": 1000000.00,\n    \"sellPrice\": 950000.00,\n    \"dateSold\": \"2022-01-01T00:00:00Z\",\n    \"datePublished\": \"2022-01-01T00:00:00Z\",\n    \"commissionRateBuyer\": 3.00,\n    \"commissionRateSeller\": 3.00,\n    \"contractType\": \"Open\",\n    \"buyerDemographic\": \"80+\",\n    \"sellerDemographic\": \"80+\",\n    \"listingUrl\" : \"test@test.com\",\n    \"listingImages\" : [\n      {\n        \"webLink\" : \"test.image1.com\",\n        \"description\" : \"Bathroom 1\"\n      },\n       {\n        \"webLink\" : \"test.image2.com\",\n        \"description\" : \"Bathroom 2\"\n      }\n    ]\n  \n}","options":{"raw":{"language":"json"}}},"url":"https://listing-api-remaxeu.bwscloud.tech/api/v1/listings?access_token=REDACTED-BY-API-EVANGELIST","description":"<p>This request is used to add listings to the Listings API. The API uses a queueing system, and some validation is done in the queue. If the validation fails (on agent for example), the record is still added to the database, but a flag is set to indicate some validation has failed.</p>\n<p>The body, as per the sample below, contain certain required fields:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">\"listingId\" : \"test-123\", // unique identifier for listing (required)\n\"status\": \"Active\",   // can be 'Inactive', 'Active', 'Expired', 'Sold', 'Sale Agreed', 'Cancelled' (required)\n\"agentUniqueId\": \"AT-P100009\", // this is the unique agent Id from Datahub (required)\n\"title\": \"Sample Title 2\", // text title \n\"description\": \"Sample Description 2\", // text description (required)\n\"roomDescription\" : \"Sample room description\", // text (optional)\n\"bedroomDescription\" : \"Sample bedroom description\", // text (optional)\n\"bathroomDesctiption\" : \"Sample bathroom description\", // text (optional)\n\"kitchenDescription\" : \"Sample kitchen description\", // text (optional)\n\"address\": \"1234 Sample Street\", // address required\n\"streetBlock\": \"Block 4\", // street block (optional)\n\"zipcode\": \"12345\", // zipcode (required)\n\"regionId\": \"AT1\", // datahub regionId (required)\n\"officeId\":\"AT1-F1079993\", // datahub officeId (required)\n\"city\": \"Vienna2\", // city name (required)\n\"country\": \"Austria\", // country name (required)\n\"offerType\": \"Sale\", // can be 'Sale' or 'Rental' (required)\n\"listingType\": \"Commercial\", // can be 'Commercial' or 'Residential'\n\"propertyType\" : \"Villa\" , // text field (optional)\n// either buildingSize or propertySize must be passed, but both can also be passed\n\"buildingSize\": 1000.00,  // number, building size (optional)\n\"propertySize\": 2000.00,  // number, property size (optional)\n\"sizeUnit\": \"m2\",    // size unit of buildingSize and propertySize (required)\n\"virtualTour\": \"No\", // string value (required)\n\"noOfRooms\": 5, // number (optoonal)\n\"noOfBathrooms\": 2, // number (optional)\n\"noOfBedrooms\" : 3, // number (optional)\n\"constructionYear\": 2000, // construction year (required)\n\"energyRating\": \"A\", // energy rating (required)\n\"floorNumber\": \"1\",  // floor number, (required)\n\"elevatorAccess\": \"Yes\", // string value (optional, can also be null, or left out)\n\"outsideAreaType\": \"Garden\", // optional \n\"outsideAreaSize\": \"Large\", // optional\n\"listingPrice\": 1000000.00, // number value (required)\n\"listingCurrency\":  \"eur\", // Currency ISO\n\"sellPrice\": 950000.00, // sell price (optional)\n\"dateSold\": \"2022-01-01T00:00:00Z\", // optional value\n\"datePublished\": \"2022-01-01T00:00:00Z\", // required\n\"listingUrl\" : \"https://listing.com/1234\", // required\n\"commissionRateBuyer\": 3.00, // optional\n\"commissionRateSeller\": 3.00, // optional\n\"contractType\": \"Open\", // can be 'Open', 'Exclusive', 'Excluded for Cooperation' (required)\n\"buyerDemographic\": \"80+\", // can be '18 - 35', '36 - 50', '51 - 65', '66 - 80', '80+' (optional)\n\"sellerDemographic\": \"80+\", // can be '18 - 35', '36 - 50', '51 - 65', '66 - 80', '80+' (optional)\n\"listingImages\" : [ //images are optional\n  {\n    \"webLink\" : \"test.image1.com\", // this is required if image is passed\n    \"description\" : \"Bathroom 1\" // this is required if image is passed\n    \"isPrimary\": true // this will use the image as the cover image for the listing\n  },\n  {\n     \"webLink\" : \"test.image2.com\", // this is required if image is passed\n     \"description\" : \"Bathroom 2\" // this is required if image is passed\n     \"isPrimary\": false\n   }\n],\n\"agentImage\" : \n {\n    \"webLink\" : \"test.image1.com\",\n    \"description\" : \"Agent Image Test\",\n    \"isPrimary\" : true\n }\n\n</code></pre>\n<p>The listing will be added to the queuing system: three parameters are passed that cannot be validated asynchronously:</p>\n<ul>\n<li><p>agentId</p>\n</li>\n<li><p>regionId</p>\n</li>\n<li><p>officeId</p>\n</li>\n</ul>\n<p>The application searches for a valid agent, region and office using the passed values. If an agent, region or office cannot be found in the RE/MAX EU Datahub database, a 'null' value is saved for agent, region or office and the appropriate flag is set: agentMatched is set if the agent is found, officeMatched is set if the office is found, regionMatched is set if the region is found.</p>\n","urlObject":{"path":["api","v1","listings"],"host":["https://listing-api-remaxeu.bwscloud.tech"],"query":[{"description":{"content":"<p>OAuth Access Token</p>\n","type":"text/plain"},"key":"access_token","value":"REDACTED-BY-API-EVANGELIST"}],"variable":[]}},"response":[],"_postman_id":"c1b53238-462c-46ff-ad5d-6dea16d61193"},{"name":"Add Listing With Images","id":"2feb260d-1a30-4cfa-abd7-445704d0e45c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"listingId","value":"test-123","description":"<p>Unique identifier for listing (required)</p>\n","type":"text","uuid":"1c2e059f-d4b0-4c83-8191-405161aada69"},{"key":"agentUniqueId","value":"CH1-P10002","description":"<p>Required</p>\n","type":"text","uuid":"0f32f420-bafb-4f1d-946b-a5cbd99a2135"},{"key":"status","value":"Active","description":"<p>'Inactive', 'Active', 'Expired', 'Sold', 'Sale Agreed', 'Cancelled' (required)</p>\n","type":"text","uuid":"c6246804-35f6-4bf0-bbb6-c9ce83ff7eb6"},{"key":"title","value":"Listing Title","type":"text","uuid":"b0dfccb8-4210-4339-b866-8123d53a68fe"},{"key":"description","value":"Listing Description","type":"text","uuid":"df6c1d5a-d766-4d0a-b95d-075f2a0ea0b0"},{"key":"roomDescription","value":"Room description text","description":"<p>Optional</p>\n","type":"text","uuid":"34121f6f-dfa1-4508-802b-60ee982337e1"},{"key":"bedroomDescription","value":"Bedroom description text","description":"<p>Optional</p>\n","type":"text","uuid":"e99ffb43-f82b-4cf1-8031-12502e42eae9"},{"key":"bathroomDescription","value":"Bathroom description text","description":"<p>Optional</p>\n","type":"text","uuid":"fba7db8a-8c2e-4ed4-8b10-b330f8080a58"},{"key":"kitchenDescription","value":"Kitchen description text","description":"<p>Optional</p>\n","type":"text","uuid":"22f3dff7-b259-4301-97c9-1592ba8eb3bd"},{"key":"address","value":"1 Church Street","description":"<p>Required</p>\n","type":"text","uuid":"edac5335-e126-4dc3-b25a-bfeda3a9d2d2"},{"key":"streetBlock","value":"Block 4","description":"<p>Optional</p>\n","type":"text","uuid":"734dd8fa-642a-4db6-b1aa-c177c3bdd58b"},{"key":"zipcode","value":"1234","description":"<p>Required</p>\n","type":"text","uuid":"69a6faef-92a8-426e-a919-094b127565a9"},{"key":"regionId","value":"CH1","description":"<p>Required</p>\n","type":"text","uuid":"c06bd05f-22fd-46a9-8cd3-92287499b066"},{"key":"officeId","value":"CH1-F1079993","description":"<p>Required</p>\n","type":"text","uuid":"c7e123e2-8949-44b3-bed4-1c4dd393d5a8"},{"key":"city","value":"Laktasi","description":"<p>Required</p>\n","type":"text","uuid":"11695f75-6d9f-42dc-98c3-170e30bb7e3f"},{"key":"country","value":"Malta","description":"<p>Required</p>\n","type":"text","uuid":"c9f4e605-4ff6-499d-9850-866512ae8f71"},{"key":"offerType","value":"Sale","description":"<p>'Sale' or 'Rental'</p>\n","type":"text","uuid":"af267c30-4432-4ae7-ac79-3ab3790ea3c4"},{"key":"listingType","value":"Commercial ","description":"<p>'Commercial' or 'Residential'</p>\n","type":"text","uuid":"a67407d4-097e-4474-8f62-9510e41a3293"},{"key":"propertyType","value":"Villa","description":"<p>Optional</p>\n","type":"text","uuid":"12e658f0-54bb-494b-b8eb-a22bb931b987"},{"key":"buildingSize","value":"165","description":"<p>Optional</p>\n","type":"text","uuid":"b5853968-a2a4-45a6-804f-a3c02073e770"},{"key":"propertySize","value":"200","description":"<p>Optional</p>\n","type":"text","uuid":"db786715-4cc7-4776-b72d-22338be90333"},{"key":"sizeUnit","value":"m2","description":"<p>Optional</p>\n","type":"text","uuid":"bbc09edb-c529-4168-b76e-6bc3d44da92d"},{"key":"virtualTour","value":"No","description":"<p>Required</p>\n","type":"text","uuid":"c975dce8-bcf0-4937-88b9-dc0bb10e5872"},{"key":"noOfRooms","value":"3","description":"<p>Required</p>\n","type":"text","uuid":"8bec03ca-1424-4aa2-8ca7-aa87018529f3"},{"key":"noOfBedrooms","value":"1","description":"<p>Required</p>\n","type":"text","uuid":"d0f512f4-f37e-4497-a41d-c0269396ea86"},{"key":"noOfBathrooms","value":"2","description":"<p>Required</p>\n","type":"text","uuid":"dd142d49-adf9-41e6-8da6-82f01d39626b"},{"key":"constructionYear","value":"2000","description":"<p>Required</p>\n","type":"text","uuid":"19cee53d-eaca-4f62-9dc8-3756d23c203c"},{"key":"energyRating","value":"AAA+","description":"<p>Required</p>\n","type":"text","uuid":"c1bec5a2-e531-4d9b-ae5f-67b44e1e8a4e"},{"key":"floorNumber","value":"1","description":"<p>Required</p>\n","type":"text","uuid":"c69a17dc-f7a5-4786-bf13-81f907b595d7"},{"key":"elevatorAccess","value":"No","description":"<p>Required</p>\n","type":"text","uuid":"4879aee2-db2e-4b46-a8f0-2c7d54088563"},{"key":"outsideAreaType","value":"Garden","description":"<p>Optional</p>\n","type":"text","uuid":"00517718-43ec-43bf-8d7c-e4002ed40608"},{"key":"outsideAreaSize","value":"1000","description":"<p>Optional</p>\n","type":"text","uuid":"8953c06a-cf00-424c-ab9a-3fa6ec7720d4"},{"key":"listingPrice","value":"100000","description":"<p>Required</p>\n","type":"text","uuid":"91e73ead-4f3e-41dc-99d5-91d8f535783d"},{"key":"listingCurrency","value":"EUR","description":"<p>Required</p>\n","type":"text","uuid":"910d8628-a776-45fb-9fea-461f02bac3cb"},{"key":"datePublished","value":"2022-01-01T00:00:00Z","description":"<p>Required</p>\n","type":"text","uuid":"cc478d5e-7849-4625-8c03-6d6258d90e0f"},{"key":"dateSold","value":"2022-01-01T00:00:00Z","description":"<p>Optional</p>\n","type":"text","uuid":"332f8b8a-19b5-4268-9ffc-d7d4fb2f3a15"},{"key":"listingUrl","value":"https://listing.com/1234","description":"<p>Required</p>\n","type":"text","uuid":"5734d2f9-02be-4d1d-a69e-817a0101f6f6"},{"key":"commissionRateBuyer","value":"2","description":"<p>Optional</p>\n","type":"text","uuid":"fd93bcb8-239c-4b48-a2c5-3ce2fb71e81a"},{"key":"commissionRateSeller","value":"3","description":"<p>Optional</p>\n","type":"text","uuid":"e74d3095-ff86-4674-b683-baab78d07a24"},{"key":"contractType","value":"Open","description":"<p>'Open', 'Exclusive', 'Excluded for Cooperation' (required)</p>\n","type":"text","uuid":"55de2166-69f1-461d-824d-c70969be5ba6"},{"key":"buyerDemographic","value":"80+","description":"<p>'18 - 35', '36 - 50', '51 - 65', '66 - 80', '80+' (optional)</p>\n","type":"text","uuid":"7df49fb5-ea12-4001-9baf-1cc16e2bfde0"},{"key":"sellerDemographic","value":"80+","description":"<p>'18 - 35', '36 - 50', '51 - 65', '66 - 80', '80+' (optional)</p>\n","type":"text","uuid":"4179f5d0-9b27-4848-b056-5e3c1a3d945e"},{"key":"agentImage","value":"{\n    \"webLink\" : \"test.image1.com\",\n    \"description\" : \"Agent Image Test\",\n    \"isPrimary\" : true\n }\n","description":"<p>JSON with Agent Image</p>\n","type":"text","uuid":"29edcf2f-51c2-4a6d-a7c8-d8ca1f397a1f"},{"key":"image","type":"file","uuid":"38920017-af4c-40c2-b4ca-e9389abdbd7a","src":"kO6kOTAGE/Screenshot 2026-03-13 at 15.49.00.png"},{"key":"image","type":"file","uuid":"457f9c99-cd1d-4b51-a263-62d55f6603a7","src":"CzB6cqSw7/Screenshot 2026-03-13 at 15.49.00.png"},{"key":"imagePrimaryFlags","value":"[\"true\", \"false\"]","description":"<p>Array with image primary flags</p>\n","type":"text","uuid":"6d4e57d5-42f0-4181-bd8b-4413de1d47da"},{"key":"imageDescriptions","value":"[\"Bedroom\", \"Bathroom\"]","description":"<p>Array with image descriiptions</p>\n","type":"text","uuid":"179948af-1945-4460-b733-ff856928c01a"}]},"url":"https://listing-api-remaxeu.bwscloud.tech/api/v1/listings?access_token=REDACTED-BY-API-EVANGELIST","description":"<p>This request is used to add listings to the Listings API. The API uses a queueing system, and some validation is done in the queue. If the validation fails (on agent for example), the record is still added to the database, but a flag is set to indicate some validation has failed.</p>\n<p>The body and image files should be added as form data (please refer. the body tab for examples. Image files of type JPG, JPEG and PNG are accepted, up to a maximum filesize of 3MB each, and up to a maximum of 40 images.</p>\n<p>The listing will be added to the queuing system: three parameters are passed that cannot be validated asynchronously:</p>\n<ul>\n<li><p>agentId</p>\n</li>\n<li><p>regionId</p>\n</li>\n<li><p>officeId</p>\n</li>\n</ul>\n<p>The application searches for a valid agent, region and office using the passed values. If an agent, region or office cannot be found in the RE/MAX EU Datahub database, a 'null' value is saved for agent, region or office and the appropriate flag is set: agentMatched is set if the agent is found, officeMatched is set if the office is found, regionMatched is set if the region is found.</p>\n","urlObject":{"path":["api","v1","listings"],"host":["https://listing-api-remaxeu.bwscloud.tech"],"query":[{"description":{"content":"<p>OAuth Access Token</p>\n","type":"text/plain"},"key":"access_token","value":"REDACTED-BY-API-EVANGELIST"}],"variable":[]}},"response":[],"_postman_id":"2feb260d-1a30-4cfa-abd7-445704d0e45c"},{"name":"Add Image To Existing Listing By ListingId and RegionId","id":"ee69a334-4ef1-4fae-ac09-c3e66a713d4b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"POST","header":[],"body":{"mode":"formdata","formdata":[{"key":"image","type":"file","uuid":"bcb49433-6875-4e8f-b4b2-ff032bfcb4bd","src":"4mYxxdZYA/Screenshot 2026-03-06 at 16.44.36.png"},{"key":"image","type":"file","uuid":"706f8ea4-c5d6-4c64-9d8f-e1d8a84f44c1","src":"_qE42pLJQ/Screenshot 2026-03-06 at 16.44.36.png"},{"key":"imagePrimaryFlags","value":"[\"true\", \"false\"]","type":"text","uuid":"8d6ecb95-397c-4139-b407-cce0d3470566"},{"key":"imageDescriptions","value":"[\"Bedroom\", \"Bathroom\"]","type":"text","uuid":"b7b4395d-3a9e-484f-9186-7908bca62348"}]},"url":"https://listing-api-remaxeu.bwscloud.tech/api/v1/listings/addImagesByListingIdAndRegionId?access_token=access_token&listingId=listing_id&regionId=region_id","description":"<p>This request is used to add listings to the Listings API. The API uses a queueing system, and some validation is done in the queue. If the validation fails (on agent for example), the record is still added to the database, but a flag is set to indicate some validation has failed.</p>\n<p>The body, as per the sample below, contain certain required fields:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">\"listingId\" : \"test-123\", // unique identifier for listing (required)\n\"status\": \"Active\",   // can be 'Inactive', 'Active', 'Expired', 'Sold', 'Sale Agreed', 'Cancelled' (required)\n\"agentUniqueId\": \"AT-P100009\", // this is the unique agent Id from Datahub (required)\n\"title\": \"Sample Title 2\", // text title \n\"description\": \"Sample Description 2\", // text description (required)\n\"roomDescription\" : \"Sample room description\", // text (optional)\n\"bedroomDescription\" : \"Sample bedroom description\", // text (optional)\n\"bathroomDesctiption\" : \"Sample bathroom description\", // text (optional)\n\"kitchenDescription\" : \"Sample kitchen description\", // text (optional)\n\"address\": \"1234 Sample Street\", // address required\n\"streetBlock\": \"Block 4\", // street block (optional)\n\"zipcode\": \"12345\", // zipcode (required)\n\"regionId\": \"AT1\", // datahub regionId (required)\n\"officeId\":\"AT1-F1079993\", // datahub officeId (required)\n\"city\": \"Vienna2\", // city name (required)\n\"country\": \"Austria\", // country name (required)\n\"offerType\": \"Sale\", // can be 'Sale' or 'Rental' (required)\n\"listingType\": \"Commercial\", // can be 'Commercial' or 'Residential'\n\"propertyType\" : \"Villa\" , // text field (optional)\n// either buildingSize or propertySize must be passed, but both can also be passed\n\"buildingSize\": 1000.00,  // number, building size (optional)\n\"propertySize\": 2000.00,  // number, property size (optional)\n\"sizeUnit\": \"m2\",    // size unit of buildingSize and propertySize (required)\n\"virtualTour\": \"No\", // string value (required)\n\"noOfRooms\": 5, // number (optoonal)\n\"noOfBathrooms\": 2, // number (optional)\n\"noOfBedrooms\" : 3, // number (optional)\n\"constructionYear\": 2000, // construction year (required)\n\"energyRating\": \"A\", // energy rating (required)\n\"floorNumber\": \"1\",  // floor number, (required)\n\"elevatorAccess\": \"Yes\", // string value (optional, can also be null, or left out)\n\"outsideAreaType\": \"Garden\", // optional \n\"outsideAreaSize\": \"Large\", // optional\n\"listingPrice\": 1000000.00, // number value (required)\n\"listingCurrency\":  \"eur\", // Currency ISO\n\"sellPrice\": 950000.00, // sell price (optional)\n\"dateSold\": \"2022-01-01T00:00:00Z\", // optional value\n\"datePublished\": \"2022-01-01T00:00:00Z\", // required\n\"listingUrl\" : \"https://listing.com/1234\", // required\n\"commissionRateBuyer\": 3.00, // optional\n\"commissionRateSeller\": 3.00, // optional\n\"contractType\": \"Open\", // can be 'Open', 'Exclusive', 'Excluded for Cooperation' (required)\n\"buyerDemographic\": \"80+\", // can be '18 - 35', '36 - 50', '51 - 65', '66 - 80', '80+' (optional)\n\"sellerDemographic\": \"80+\", // can be '18 - 35', '36 - 50', '51 - 65', '66 - 80', '80+' (optional)\n\"listingImages\" : [ //images are optional\n  {\n    \"webLink\" : \"test.image1.com\", // this is required if image is passed\n    \"description\" : \"Bathroom 1\" // this is required if image is passed\n    \"isPrimary\": true // this will use the image as the cover image for the listing\n  },\n  {\n     \"webLink\" : \"test.image2.com\", // this is required if image is passed\n     \"description\" : \"Bathroom 2\" // this is required if image is passed\n     \"isPrimary\": false\n   }\n],\n\"agentImage\" : \n {\n    \"webLink\" : \"test.image1.com\",\n    \"description\" : \"Agent Image Test\",\n    \"isPrimary\" : true\n }\n\n</code></pre>\n<p>The listing will be added to the queuing system: three parameters are passed that cannot be validated asynchronously:</p>\n<ul>\n<li><p>agentId</p>\n</li>\n<li><p>regionId</p>\n</li>\n<li><p>officeId</p>\n</li>\n</ul>\n<p>The application searches for a valid agent, region and office using the passed values. If an agent, region or office cannot be found in the RE/MAX EU Datahub database, a 'null' value is saved for agent, region or office and the appropriate flag is set: agentMatched is set if the agent is found, officeMatched is set if the office is found, regionMatched is set if the region is found.</p>\n","urlObject":{"path":["api","v1","listings","addImagesByListingIdAndRegionId"],"host":["https://listing-api-remaxeu.bwscloud.tech"],"query":[{"key":"access_token","value":"access_token"},{"key":"listingId","value":"listing_id"},{"key":"regionId","value":"region_id"}],"variable":[]}},"response":[],"_postman_id":"ee69a334-4ef1-4fae-ac09-c3e66a713d4b"},{"name":"Get Listings Detail By RegionId and ListingId","id":"a3b07ae9-5d16-4d86-bbb2-8802076095ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[],"url":"https://listing-api-remaxeu.bwscloud.tech/api/v1/listings/getByRegionIdAndListingId?listingId=testspecial3&regionId=GR1","description":"<p>This request returns detail of a listing, specifying the Remax listingId and Remax regionId as query parameters</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">    {\n        \"id\": 1,\n        \"title\": \"Sample Title 1\",\n        \"description\": \"Sample Description 1\",\n        \"address\": \"1234 Sample Street\",\n        ...\n    },\n\n</code></pre>\n","urlObject":{"path":["api","v1","listings","getByRegionIdAndListingId"],"host":["https://listing-api-remaxeu.bwscloud.tech"],"query":[{"description":{"content":"<p>ID added from system adding the listings</p>\n","type":"text/plain"},"key":"listingId","value":"testspecial3"},{"description":{"content":"<p>The Remax regionId for the record</p>\n","type":"text/plain"},"key":"regionId","value":"GR1"}],"variable":[]}},"response":[],"_postman_id":"a3b07ae9-5d16-4d86-bbb2-8802076095ca"},{"name":"Update Listing By RegionId and ListingId","id":"dc8f2671-f3a9-4ead-9950-80b443b324d6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n    \"listingId\" : \"765-1032\",  // ID from your system for later reference\n    \"status\": \"Active\",\n    \"agentUniqueId\": \"CH2-P100002\",\n    \"title\": \"Sample Title 2\",\n    \"description\": \"Sample Description 2\",\n    \"roomDescription\" : \"Sample room description\",\n    \"bathroomDescription\" : \"Sample bathroom description\",\n    \"bedroomDescription\" : \"Sample bedroom description\",\n    \"kitchenDescription\" : \"Sample kitchen description\",\n    \"address\": \"1234 Sample Street\",\n    \"streetBlock\": \"Block 4\",\n    \"zipcode\": \"12345\",\n    \"regionId\": \"FI1\",\n    \"officeId\":\"FI1-F1079993\",\n    \"city\": \"Friesneksor\",\n    \"country\": \"Finland\",\n    \"offerType\": \"Sale\",\n    \"listingType\": \"Commercial\",\n    \"buildingSize\": 1000.00,\n    \"propertySize\": 2000.00,\n    \"sizeUnit\": \"m2\",\n    \"virtualTour\": \"No\",\n    \"noOfRooms\": 5,\n    \"noOfBathrooms\": 2,\n    \"noOfBedrooms\" : 2,\n    \"constructionYear\": 2000,\n    \"energyRating\": \"A\",\n    \"floorNumber\": \"1\",\n    \"elevatorAccess\": \"Yes\",\n    \"outsideAreaType\": \"Garden\",\n    \"outsideAreaSize\": \"Large\",\n    \"listingCurrency\": \"EUR\",\n    \"listingPrice\": 1000000.00,\n    \"sellPrice\": 950000.00,\n    \"dateSold\": \"2022-01-01T00:00:00Z\",\n    \"datePublished\": \"2022-01-01T00:00:00Z\",\n    \"commissionRateBuyer\": 3.00,\n    \"commissionRateSeller\": 3.00,\n    \"contractType\": \"Open\",\n    \"buyerDemographic\": \"80+\",\n    \"sellerDemographic\": \"80+\",\n    \"listingUrl\" : \"test@test.com\",\n    \"listingImages\" : [\n      {\n        \"webLink\" : \"test.image1.com\",\n        \"description\" : \"Bathroom 1\"\n      },\n       {\n        \"webLink\" : \"test.image2.com\",\n        \"description\" : \"Bathroom 2\"\n      }\n    ]\n  \n}","options":{"raw":{"language":"json"}}},"url":"https://listing-api-remaxeu.bwscloud.tech/api/v1/listings/updateByRegionIdAndListingId?regionId=CH1&listingId=765-1032&access_token=<access_token>","description":"<p>This request is used to update a listing in the Listings API using the listingId and regionId field as query parameters.</p>\n<p>The body, as per the sample below, contains certain required fields:</p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">\"listingId\" : \"test-123\", // unique identifier for listing (required)\n\"status\": \"Active\",   // can be 'Inactive', 'Active', 'Expired', 'Sold', 'Sale Agreed', 'Cancelled' (required)\n\"agentUniqueId\": \"AT-P100009\", // this is the unique agent Id from Datahub (required)\n\"title\": \"Sample Title 2\", // text title (required)\n\"description\": \"Sample Description 2\", // text description (required)\n\"roomDescription\" : \"Sample room description\", // text (optional)\n\"bedroomDescription\" : \"Sample bedroom description\", // text (optional)\n\"bathroomDesctiption\" : \"Sample bathroom description\", // text (optional)\n\"kitchenDescription\" : \"Sample kitchen description\", // text (optional)\n\"address\": \"1234 Sample Street\", // address required\n\"streetBlock\": \"Block 4\", // street block (optional)\n\"zipcode\": \"12345\", // zipcode (required)\n\"regionId\": \"AT1\", // datahub regionId (required)\n\"officeId\":\"AT1-F1079993\", // datahub officeId (required)\n\"city\": \"Vienna2\", // city name (required)\n\"country\": \"Austria\", // country name (required)\n\"offerType\": \"Sale\", // can be 'Sale' or 'Rental' (required)\n\"listingType\": \"Commercial\", // can be 'Commercial' or 'Residential' (required)\n\"propertyType\" : \"Villa\" , // text field (optional)\n// either buildingSize or propertySize must be passed, but both can also be passed\n\"buildingSize\": 1000.00,  // number, building size (optional)\n\"propertySize\": 2000.00,  // number, property size (optional)\n\"sizeUnit\": \"m2\",    // size unit of buildingSize and propertySize (required)\n\"virtualTour\": \"No\", // string value (required)\n\"noOfRooms\": 5, // number (optoonal)\n\"noOfBathrooms\": 2, // number (optional)\n\"noOfBedrooms\" : 3, // number (optional)\n\"constructionYear\": 2000, // construction year (optional)\n\"energyRating\": \"A\", // energy rating (required)\n\"floorNumber\": \"1\",  // floor number (string value), \"First Floor\" or \"2\" (required)\n\"elevatorAccess\": \"Yes\", // string value (required)\n\"outsideAreaType\": \"Garden\", // optional \n\"outsideAreaSize\": \"Large\", // optional\n\"listingPrice\": 1000000.00, // number value (required)\n\"sellPrice\": 950000.00, // sell price (optional)\n\"dateSold\": \"2022-01-01T00:00:00Z\", // optional value\n\"datePublished\": \"2022-01-01T00:00:00Z\", // required\n\"listingUrl\" : \"https://listing.com/1234\", // required\n\"commissionRateBuyer\": 3.00, // optional\n\"commissionRateSeller\": 3.00, // optional\n\"contractType\": \"Open\", // can be 'Exclusive', 'Open', 'Excluded for Cooperation' (required)\n\"buyerDemographic\": \"80+\", // can be '18 - 35', '36 - 50', '51 - 65', '66 - 80', '80+' (optional)\n\"sellerDemographic\": \"80+\", // can be '18 - 35', '36 - 50', '51 - 65', '66 - 80', '80+' (optional)\n\"listingImages\" : [ //images are optional\n  {\n    \"webLink\" : \"test.image1.com\", // this is required if image is passed\n    \"description\" : \"Bathroom 1\" // this is required if image is passed\n  },\n  {\n     \"webLink\" : \"test.image2.com\", // this is required if image is passed\n     \"description\" : \"Bathroom 2\" // this is required if image is passed\n   }\n],\n\"agentImage\" :  // optional\n {\n    \"webLink\" : \"test.image1.com\",\n    \"description\" : \"Agent Image Test\",\n    \"isPrimary\" : true\n },\n\n</code></pre>\n<p>The application searches for a valid agent, region and office using the passed values. If a agent, region or office cannot be found in the RE/MAX EU Datahub database, a 'null' value is saved for agent, region or office and the appropriate flag is set: agentMatched is set if the agent is found, officeMatched is set if the office is found, regionMatched is set if the region is found.</p>\n","urlObject":{"path":["api","v1","listings","updateByRegionIdAndListingId"],"host":["https://listing-api-remaxeu.bwscloud.tech"],"query":[{"description":{"content":"<p>Region ID of listing</p>\n","type":"text/plain"},"key":"regionId","value":"CH1"},{"description":{"content":"<p>Listing ID</p>\n","type":"text/plain"},"key":"listingId","value":"765-1032"},{"description":{"content":"<p>Access token for user</p>\n","type":"text/plain"},"key":"access_token","value":"<access_token>"}],"variable":[]}},"response":[],"_postman_id":"dc8f2671-f3a9-4ead-9950-80b443b324d6"},{"name":"Delete Listing By RegionId and ListingId","id":"b7e32158-a42a-4c44-bdc6-8d2796123dc6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"DELETE","header":[],"body":{"mode":"raw","raw":"{\n    \"listingId\" : \"test-123\",\n    \"status\": \"Active\",\n    \"agentUniqueId\": \"AT-P100009\",\n    \"title\": \"Sample Title 2\",\n    \"description\": \"Sample Description 2\",\n    \"address\": \"1234 Sample Street\",\n    \"streetBlock\": \"Block 4\",\n    \"zipcode\": \"12345\",\n    \"regionId\": 199,\n    \"officeId\":2,\n    \"city\": \"Vienna2\",\n    \"country\": \"Austria\",\n    \"offerType\": \"Sale\",\n    \"listingType\": \"Commercial\",\n    \"buildingSize\": 1000.00,\n    \"propertySize\": 2000.00,\n    \"sizeUnit\": \"m2\",\n    \"virtualTour\": \"No\",\n    \"noOfRooms\": 5,\n    \"noOfBathrooms\": 2,\n    \"constructionYear\": 2000,\n    \"energyRating\": \"A\",\n    \"floorNumber\": \"1\",\n    \"elevat

# --- truncated at 32 KB (92 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/re-max/refs/heads/main/collections/re-max-eu-listings-api.postman_collection.json