ListStream Docs

Sending listings

REAXML upload API

Already send REAXML to realestate.com.au? This endpoint has the same shape, so existing integration code can point at ListStream with few changes.

Upload

POST one REAXML document, or a zip with the XML and its photos (up to 20 MB), with your access token. You get an upload ID straight away.

http
POST https://liststream.com.au/listing/v1/upload
Authorization: Bearer eyJ...
Content-Type: application/xml

<propertyList>...</propertyList>

202 Accepted
{ "uploadId": "b8476b79-..." }

GET https://liststream.com.au/listing/v1/upload/b8476b79-...

{ "uploadId": "b8476b79-...", "progress": "COMPLETED", "result": "NEW",
  "agencyId": "EXAMPL", "externalListingId": "EX-3", "issues": { "errors": [], "warnings": [] } }

Results

The report uses realestate.com.au's result values: NEW, PROCESSED, DELETED, UNCHANGED and SKIPPED, with errors and warnings per listing. A file with several listings reports each one.

Looking up a report

  • By upload: GET /listing/v1/upload/{uploadId}
  • The latest for one listing: GET /listing/v1/upload?agencyId=…&externalListingId=…
  • The ListStream report for any delivery: GET /v1/deliveries/{id}

What the file must contain

Standard REAXML, with the agency's ListStream ID as agentID (or your sandbox ID with a test key). The details are in REAXML format.