Read visitors and leads

A visitor is a person resolved across scans and devices. Anonymous at first scan, identified once they give an email or phone (form step, attributeCapture, or the identify API). Each visitor has reserved fields (email, phone, firstName, lastName), free-form typed attributes, and counters (visitCount, deviceCount, qrcodeCount).

All REST calls: https://api.linkbreakers.com, header Authorization: Bearer <workspace token>.

1. Discover what was captured

Before filtering, list the attribute keys and their types:

• REST: GET /v1/visitors/attributes (optional ?linkId=<uuid> to scope to one QR code)
• MCP: visitors_list_attribute_keys

The response attributes[] gives key and type (VISITOR_ATTRIBUTE_TYPE_STRING, _NUMBER, _BOOLEAN, _DATE, _ENUM). Pick filter operators that fit the type.

2. List visitors