Agencies and events

Connections

A live key can only send an agency's listings after the agency approves you. ListStream never approves on an agency's behalf.

Ask an agency

Ask the agency for its six-letter ListStream ID, then request a connection with a live key. It appears in the agency's dashboard to approve.

http

POST https://liststream.com.au/v1/connections
Authorization: Bearer eyJ...      (a live key)
Content-Type: application/json

{ "liststreamId": "EXAMPL" }

202 Accepted
{ "liststreamId": "EXAMPL", "status": "requested" }

GET https://liststream.com.au/v1/connections
{ "connections": [ { "liststreamId": "EXAMPL", "status": "pending", "requestedAt": "…" } ] }

What the answers mean

A valid six-letter ID always gets 202 requested, so the answer doesn't reveal whether an agency exists.
GET /v1/connections shows a request as pending until the agency approves; the agency's name appears once it does.
You get a connection.approved or connection.revoked webhook when the agency decides.
A connection the agency revokes stays revoked unless the agency approves it again.

Limits

Up to 100 new requests a day. Test keys can't request connections (403 live_only): use your sandbox ID instead.