List install records
Lists the organization's install records, newest first, with stable ids and match details, so you can reconcile them against your own reports or keep a copy. Only matched installs have a record: an attempt that matched nothing is listed by GET /attribution/attempts instead. click_id is null when the match did not carry a click identifier (for example an Android referrer match or an older deferred payload). The device id, the hashed device match key and the stored routing payload are never returned; has_device_id, has_device_fingerprint and has_matched_payload say only whether each one is stored. Requires an API key with the analytics:read or links:read scope. SDK keys are refused with 403 SDK_KEY_ROUTE_FORBIDDEN. Records are filtered by installed_at: from is inclusive and to is exclusive. Retention and the Free plan's 30-day look-back apply as they do to the click export: 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, which window.from reports. The list is not frozen when a Free organization reaches its click limit. 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/installs
- Auth: HTTP bearer
Query parameters
Omit to read installs of every app. A UUID reads one app. The literal "none" reads only installs with no app.
Only installs attributed to this link.
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 install records
Changes
No recorded changes to this operation across all 1 revision of this API.