Listing

Search by Agent / Office

Searches active and sold listings for a specific agent (the caller by default), their office, or a set of MLS listing IDs.

Notes:

limit must be in (0, 1000]; otherwise 400 LISTING_LIMIT_NOT_VALID.
listingId and soldListingId cannot be supplied together; doing so returns an error envelope on HTTP 200.
At least one of agentListings, officeListings, listingId, soldListingId, mlsListingIds, buildingName, or buildingAddress must identify the search target.
When userId differs from the caller, caller must have MANAGE_TEAM_AGENT permission.

get/v1.0/listing

Request

Base URL
https://api.lofty.com
Auth
none required
TypeScript
https://skmtc.dev/lofty/apis/lofty-service-open-apis/docs/v1.0/listing/get.ts
A function with typed inputs. Its response is checked against the schema.

userIdinteger

listingIdstring

nextPageKeystring

soldNextPageKeystring

mlsListingIdsstring

streetstring

limitinteger

soldListingIdstring

officeListingsboolean

agentListingsboolean

buildingNamestring

buildingAddressstring

showConditionboolean

Authorizationstring required

Bearer [access_token]

Search result envelope with active listings, sold listings, and listing metadata.

listIngobject

Active listings matching the search. Structure is a listing hub payload; fields depend on the listing source.

soldListingobject

Sold listings matching the search. Same structure as listIng.

No recorded changes to this operation across all 1 revision of this API.