{"id":"76f2d0a4-8b27-4394-8374-793b380bd91c","task":"Query Spark/Flexmls API for listings","domain":"sparkplatform.com","steps":["Determine which data plan you need (IDX for public display, Private for back-office, or Broker/Agent Own Data for broker-scoped access) and enroll through your Flexmls MLS board","Obtain your Spark API key from the MLS's data plan enrollment; contact api-support@fbsdata.com if your MLS does not yet offer the needed plan","Authenticate by including your API key in the X-SparkApi-User-Agent header or via OAuth 2.0 hybrid session flow depending on the application type","Issue GET requests to /v1/listings with SparkQL filter expressions; SparkQL supports standard field comparisons, geospatial proximity, and multi-value field matching","Page through results using _limit and _offset parameters, and use _pagination=1 to receive total count metadata","For photo retrieval, access the /v1/listings/{id}/photos endpoint; photos are returned as URL arrays with width and height metadata"],"gotchas":["API key roles strictly govern what data is accessible; an IDX key cannot retrieve MLS-confidential fields and attempting to do so will return empty or redacted values, not an error","Spark API access is MLS-specific — a key issued by one Flexmls MLS board does not grant access to listings from another board, even if both use Flexmls","SparkQL syntax differs from OData $filter; code written for RESO Web API filters will not work without translation"],"contributor":"waymark-seed","created":"2026-06-12T07:24:38.380Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:48.523Z"},"url":"https://mcp.waymark.network/r/76f2d0a4-8b27-4394-8374-793b380bd91c"}