List attribution attempts
Lists every attribution attempt of the organization, matched or not, newest first. An attempt is one request from an SDK asking which click led to an install. Use it to see why installs were not tied to a click: fail_reason names the reason (no_signals, no_match, no_candidates, candidates_filtered, candidates_claimed, scored_zero, key_app_mismatch), and it is also set to ambiguous_app on a matched attempt that looked up a device-wide signal across several apps. match_source is claim when the attempt created an install and replay when it answered from an existing one, so the claims equal the records of GET /installs. No IP address, match key or device id is stored on an attempt or returned; ip_class says only whether the request came from a carrier-grade NAT, IPv4 or IPv6 address. Requires an API key with the analytics:read or links:read scope. SDK keys are refused with 403 SDK_KEY_ROUTE_FORBIDDEN. Attempts are filtered by created_at: from is inclusive and to is exclusive. Retention and the Free plan's 30-day look-back apply: a Free organization whose from is earlier than the last 30 days gets 403 LOOKBACK_EXCEEDED with details.earliest_allowed, and a from earlier than the plan's data retention is raised to it. The list is not frozen when a Free organization reaches its click limit. Attempts carry no link, so there is no link_id filter, and a member limited to their own links is refused. Page with pagination.next_cursor and send the same filters with it. A parameter this endpoint does not accept is a 400 VALIDATION_ERROR.
Request
- Base URL: https://api.warplink.app/v1
- URL: https://api.warplink.app/v1/attribution/attempts
- Auth: HTTP bearer
Query parameters
Omit to read attempts of every app. A UUID reads one app. The literal "none" reads only attempts with no app.
true reads only attempts that matched, false only attempts that did not. Omit to read both.
Start of the window, inclusive, as an ISO instant with an offset. Without it the list starts at the earliest instant your plan may read.
End of the window, exclusive, as an ISO instant with an offset. Defaults to now. Must be after from.
Records per page, 1 to 500.
The next_cursor of the previous page. Send it with the same filters. A cursor from the other list is refused with 400 CURSOR_INVALID.
Response
One page of attribution attempts
Changes
No recorded changes to this operation across all 1 revision of this API.