Store-visit measurement and location data for agencies and their advertisers. Send us your advertisers and store lists, track each store's status, pull visit records, and read the numbers on your published Quorum reports.
Base URL: https://api.quorum.live Auth: Authorization: Bearer <your-token> Health: GET https://api.quorum.live/v1/health (no auth required; /health also works)
Tokens are bound to one agency and can only read that agency's advertisers. A token may have an expiry date (an expired token gets 401) and may be read-only (POST /v1/intake/* then returns 403). Tokens are stored as SHA-256 hashes and cannot be shown again after issue. Device- and household-level routes are not available to partner tokens; use the Quorum MCP (https://mcp.quorum.live/mcp) for those questions. Details: Access and scope.
| Method | Path | Description | Auth |
|---|---|---|---|
| GET | /v1/health | Service status (alias: /health) | — |
| GET | /v1/advertisers | Your agency's advertisers, with Quorum advertiser ids | Bearer |
| POST | /v1/intake/advertisers | Send your advertisers | Bearer |
| POST | /v1/intake/locations | Send your stores (add-only) | Bearer |
| GET | /v1/intake/locations | Each store's status: submitted, pending or active | Bearer |
| GET | /v1/advertisers/{advertiser_id}/locations | Tracked locations for your advertiser | Bearer |
| GET | /v1/advertisers/{advertiser_id}/locations/{segment_md5}/visits | Visit records for one location | Bearer |
| GET | /v1/advertisers/{advertiser_id}/report | The numbers on your published report | Bearer |
| GET | /v1/partner-feed/daily | Daily exposure and visit counts, JSON or CSV | Bearer |
Every route, with fields and examples: https://api.quorum.live/documentation · try it live: https://api.quorum.live/docs
Intake takes your own DSP advertiser id. /locations, /visits and /report take it too, or a Quorum id your agency owns. The analytic roll-ups, performance tables and partner feed take the Quorum advertiser id listed by GET /v1/advertisers.
Quorum's id for a tracked location. GET /v1/intake/locations lists the segment_md5s for each of your active stores, and /locations lists every location tracked for the advertiser.
Your token sees only your agency's advertisers. Another agency's advertiser is refused (403) or not found (404), never served.
curl https://api.quorum.live/v1/health
curl https://api.quorum.live/v1/advertisers \ -H "Authorization: Bearer $TOKEN"
curl "https://api.quorum.live/v1/advertisers/12345/locations" \ -H "Authorization: Bearer $TOKEN"
| Code | Meaning |
|---|---|
202 | Advertiser recognised but not mapped yet; retry later |
401 | Missing, invalid or expired token |
403 | Not allowed for this token: route not open to partners, advertiser outside your agency, or read-only token on a write |
404 | Not found for your agency |
410 | Advertiser disconnected by your agency; reconnect to restore |
422 | Invalid request, or advertiser permanently not reportable (see detail) |
503 | Temporarily unable to verify the request; retry |
This API is in closed beta. Submit a request and you'll receive your token within one business day.
Request Access View Swagger UI