Skip to main content
GET
/
listings
listings
curl --request GET \
  --url https://api.windermere.com/v1/api/listings \
  --header 'x-api-key: <api-key>'
{
  "FinalPage": true,
  "Listings": [
    {
      "LotSizeAcres": 0,
      "BathroomsFull": 0,
      "BathroomsHalf": 0,
      "BathroomsOneQuarter": {},
      "BathroomsPartial": {},
      "BathroomsThreeQuarter": {},
      "BathroomsTotalInteger": 0,
      "BathroomsTotal": 0,
      "BedroomsTotal": 0,
      "PublicTitle": "string",
      "PublicRemarks": "string",
      "ModificationTimestamp": "string",
      "StatusChangeDate": "string",
      "InternetAddressDisplayYN": true,
      "DaysOnMarket": 0,
      "ListingContractDate": "string",
      "CreatedDate": "string",
      "ElementarySchool": "string",
      "GarageSpaces": 0,
      "WaterfrontYN": true,
      "HighSchool": "string",
      "AssociationFee": {},
      "ListOfficeName": "string",
      "ListPrice": 0,
      "ListingID": "string",
      "ListAgentFullName": "string",
      "ListAgentUUID": "string",
      "ListAgentOfficeID": "string",
      "ListAgentMoxiWorksOfficeID": "string",
      "SecondaryListAgentFullName": "string",
      "SecondaryListAgentUUID": "string",
      "SchoolDistrict": "string",
      "Address": "string",
      "Address2": {},
      "City": "string",
      "CountyOrParish": "string",
      "Latitude": "string",
      "Longitude": "string",
      "StateOrProvince": "string",
      "PostalCode": "string",
      "Community": "string",
      "LotSizeSquareFeet": {},
      "InternetEntireListingDisplayYN": true,
      "MiddleOrJuniorSchool": "string",
      "ListOfficeAOR": "string",
      "ListOfficeAORArea": "string",
      "NewConstructionYN": true,
      "PoolYN": true,
      "PropertyType": "string",
      "TaxAnnualAmount": 0,
      "TaxYear": 0,
      "SingleStory": true,
      "LivingArea": 0,
      "ViewYN": true,
      "YearBuilt": 0,
      "OnMarket": true,
      "Status": "string",
      "MoxiWorksListingId": "string",
      "AgentCreatedListing": true,
      "VirtualTourURL": "string",
      "SharedPartnerData": {
        "attribute_1": "string",
        "attribute_2": "string"
      },
      "TaxParcelId": "string",
      "ListingURL": "string",
      "PropertyFeatures": [
        {
          "PropertyFeatureName": "string",
          "PropertyFeatureValues": [
            "string"
          ]
        }
      ],
      "CompanyListingAttributes": [
        {
          "AttributeId": "string",
          "AttributeName": "string"
        }
      ],
      "OpenHouse": [
        {
          "Date": "string",
          "StartTime": "string",
          "EndTime": "string",
          "VirtualOpenHouseYN": true,
          "VirtualOpenHouseURL": {},
          "Comment": {}
        }
      ],
      "ImagesLastModified": "string",
      "ListingImages": [
        {
          "FullURL": "string",
          "GalleryURL": "string",
          "RawURL": "string",
          "SmallURL": "string",
          "ThumbURL": "string",
          "Title": "string",
          "IsMainListingImage": true,
          "Caption": "string",
          "Description": "string",
          "Width": 0,
          "Height": 0,
          "MimeType": "string"
        }
      ],
      "BuyerCommissionType": "string",
      "BuyerCommissionValue": "string",
      "VendorModificationTimestamp": "string"
    }
  ]
}

Authorizations

x-api-key
string
header
required

Query Parameters

moxi_works_company_id
string
required

A valid MoxiWorks Company ID. Use Company Endpoint to determine what moxi_works_company_id you can use.

parent_company_id
string

This is the numeric_id or moxi_works_company_id of a company that is considered to be a parent company in the MoxiWorks Platform. This request attribute has two functions:

  1. It provides for a broad scope by which partners may be afforded permissions to perform MoxiWorks Platform actions, in scenarios where a partner does business with a parent company in the MoxiWorks System.
  2. It provides broad scope under which agents may be looked up using the source_agent_id request attribute in many scenarios across different MoxiWorks Platform endpoints and actions.

Please note that this attribute cannot be used as a replacement for the moxi_works_company_id request attribute in scenarios where the moxi_works_company_id request attribute is required by the action.

Please note that this attribute cannot be used to broaden scope of any request where the scope of the request is defined by the moxi_works_company_id request attribute.

Please note that when passed in conjunction with the moxi_works_company_id request attribute, the value of moxi_works_company_id request attribute must be the numeric id form.

Any use of this request attribute must be coordinated with MoxiWorks Platform Partner services. Please reach out to partner services for more information.

updated_since
integer

Paged responses of all Listing objects updated after this Unix timestamp will be returned in the response. If no updated_since parameter is included in the request, only Listing objects updated in the last seven days will be returned.

agent_uuid
string

This is the MoxiWorks Platform ID of the Agent which Listing objects are associated with. This will be an RFC 4122 compliant UUID.

moxi_works_agent_id
string

Use this parameter when searching for Listing objects associated with a specific Agent. This will be a string that may take the form of an email address, or a unique identification string. This data must reference a valid MoxiWorks Agent ID for your Listing Index request to be accepted.

A company’s internal agent id may be used to construct the agent’s unique identification string. To do so, the value passed via the moxi_works_agent_id should be a single concatenated string, of the form: [moxi_works_company_id]:[internal_agent_id] Use Company Endpoint to determine which moxi_works_company_id to use.

moxi_works_office_id
string

Use this parameter when searching for Listing objects associated with a specific Office. This data must reference a valid MoxiWorks Office ID for your Listing Index request to be accepted.

last_moxi_works_listing_id
string

If fetching a multi-page response, this should be the MoxiWorksListingId found in the last Listing object of the previously fetched page.

shared_partner_data_updated_since
integer

Include additional listings using this unix timestamp representing the date since partner data has been updated. This attribute should be used in conjuncion with the updated_since attribute.

market_status
string

When filtering by market_status use one of the following options:

Value Description on-market The default value for market_status. This listing set includes ‘Active,’ ‘Pending’ and ‘Contingent’ listings. off-market If market_status is set to this value, only off-market listings will be returned. all When market_status is set to this value, both off-market and on-market listings will be returned.

property_types
string

When filtering by property_types pass a comma separated string of integers associated with various property types. When property_types is not inlcuded, all property types will be included in the response.

Use this legend to determine which integer values to include in property_types.

Number Property Type -1 Not Found 1 Residential 2 Condo 3 Land 4 Mfghome 5 Farm/Ranch 6 Rental 7 Multifamily 8 Co-op 9 Townhouse 10 Commerical 11 Business Opportunity 12 Commercial Res Income 13 Commercial Hotel 14 Commercial Mobile Home Park 15 Commercial Lease 16 Commercial Land 17 Moorage 18 Timeshare 19 Commercial Industrial 20 Multifamily2_4 21 Multifamily5up 22 Apartment 23 Highrise

only_agent_created
boolean

When this filter parameter is passed as true, the response will be restricted to listings created by agents (non-mls listings).

coming_soon
boolean

When this attribute is passed as true only listings with status “ComingSoon” will be returned.

underscore_response
boolean

When this attribute is passed as true, the json keys of the response will be underscored. The default json key format for listing responses is camel casing.

timestamps_only
boolean

If supplied then the results will exclude all data except primary identifiers and a unix timestamp (last_updated) & iso8601 timestamp (modification_timestamp) of the last time this record was updated.

Response

200 - application/json
FinalPage
boolean
Listings
object[]