API Reference

Identify user by fingerprint

get
https://api.web2wave.com/api/user/identify

Identifies a user based on request fingerprint (IP address, User-Agent, and optional device data).
Matching prefers recent visits from the same IP (last 48 hours), then a unique device fingerprint. device_model is preferred over screen_size. Country is resolved from the request IP. Headers (or query params) improve matching when multiple users share an IP.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Device screen size for fingerprint matching.

string

Client timezone for fingerprint matching.

string

OS version for enhanced fingerprint matching.

string

Hardware model for fingerprint matching (preferred over screen_size).

Headers
string
required

API key for authentication.

string
required

Client user agent used for fingerprint matching.

string

Device/platform for fingerprint matching (e.g. ios, android, web).

string

Device screen size for fingerprint matching. May also be sent as query param.

string

Client timezone for fingerprint matching. May also be sent as query param.

string

OS version for enhanced fingerprint matching. May also be sent as query param.

string

Hardware model for fingerprint matching (preferred over screen_size). May also be sent as query param. Examples: Pixel 8, SM-S911B, iPhone15,2.

Responses

422

Validation error (e.g. invalid parameters).

500

Server error during identification.

Updated 4 months ago

Did this page help you?
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago

Did this page help you?