Get user visits list

Retrieve a list of visits for a specific user, including UTM parameters, device details, and geographic location for each visit.

get/user/user_visits

Request

Base URL
https://api.web2wave.com/api
URL
https://api.web2wave.com/api/user/user_visits
Auth
API key in header api_key

Query parameters

userstring required

Email or user GUID of the user whose visits you want to retrieve.

limitinteger

Number of visits to return (max 100).

offsetinteger

Number of visits to skip for pagination.

Headers

api_keystring required

API key for authentication.

Response

User visits list retrieved successfully.

user_idstring

A unique identifier for the user.

user_emailstring

The user's email address.

Example response

{
  "user_id": "c1409762-d624-4a47-a330-2a21d108b681",
  "user_email": "user@example.com",
  "user_visits": [
    {
      "id": "cd6e3a40-fffe-4cf1-9432-124fcf8a4322",
      "created_at": "2025-04-21T17:37:04Z",
      "project_id": 589,
      "user_id": "4f935f81-8620-4d6a-b3b7-4738e933e3f2",
      "ip": "192.168.1.1",
      "url": "https://quiz.example.com/learn-language",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_3_2 like Mac OS X) AppleWebKit/605.1.15",
      "is_first_visit": 1,
      "visit_number": 1,
      "first_visit_date": "2025-04-21T17:37:04Z",
      "previous_visit_date": "2025-04-20T15:30:00Z",
      "user_platform": "iOS",
      "user_language": "en",
      "user_country_code": "US",
      "user_state_code": "CA",
      "user_city_name": "San Francisco",
      "user_zip_code": "94102",
      "utm_source": "facebook",
      "utm_medium": "paid",
      "utm_campaign": "summer_2024",
      "utm_content": "ad_variant_1",
      "utm_term": "language_learning",
      "utm_ad_id": "120219538872100620",
      "utm_adset": "Language Learning Ad Set",
      "utm_adname": "Learn English Fast",
      "utm_adset_id": "120219538872190620",
      "utm_id": "120219538872090620",
      "fbclid": "PAZXh0bgNhZW0BMABhZGlkAasbCOfpPCwBp7Pjd0fj0I4Iq6wMoxpwfPY56ByjnwtDEdd_Akfl6UyZRpvJDsdjhQrDatOb_aem_X4VgON_xZ-6GXC2H3_NI6w",
      "ttclid": "ttc123456789",
      "gbraid": "1.1.example",
      "gclid": "CjwKCAjw...",
      "fbc": "fb.1.1554763741205.IwAR2F4..."
    }
  ],
  "pagination": {
    "limit": 50,
    "count": 25
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.