ListStream Docs

Authentication

Test mode

Build and test against the real API without publishing anything.

Your sandbox ID

Every developer account has a sandbox agent ID: SB plus four letters, shown in the console. Test keys only accept listings with that ID, as the liststreamId in the path or the REAXML agentID. Anything else gets 403 not_sandbox.

What happens to test deliveries

  • They go through the same checks as live ones and get the same kind of report.
  • Nothing is published and no listing is kept, so sending the same listing twice reports it as new both times, and a status change or removal is reported as skipped.
  • Test reports are kept for 90 days, like live ones. Webhooks fire for test deliveries too, to your test endpoint.

Going live

Create a live key and connect to agencies (Connections). A live key used with your sandbox ID gets 403 use_test_key.