id as {domain_id}. That value is a UUID, not the hostname. The literal all returns 403. Search lists identifications or users. Card reads one record.
Methods
A list of
visitor, device, or ip returns 403. Read those one record at a time.
Authentication
Bearer PRIVATE_API_KEY. Use the domain’s Private API Key, not its browser Public Key or Management Secret Key.404. For a new Identification ID, use a bounded retry or an SDK retrieval helper. Bind the result to the expected domain, account and protected action before using it.
Path parameters
identifications or user for a list. identifications, user, visitor, device, or ip for one record.all, an empty id, . or .., a slash, a backslash, or a control character is rejected.
Query parameters
Window start, RFC 3339. Send
from and to together, or omit both. A list defaults to the last 24 hours.true or false. The same form applies to the other published is_* flags, network_check_incomplete, check_incomplete, ip_mismatch, latency_test, device_spoofing, banned_ip, ai_bot, and ai_browser. Several flags combine with AND.Traffic source. Repeat with
campaign. At most 8 values together, matched if any value matches. _empty means no referrer.filter, chips, or offset returns 400.
Response
A list returns{ "data": [ ... ], "next_page_token": null }. One record returns { "data": { ... } }. Successful responses also send History-Snapshot, History-Snapshot-Expires-At, History-Window-From, and History-Window-To.
One card, or the cards for this page. See History card.
Pagination
List one user’s identifications and follownext_page_token:
429.