---
title: "Get user visits list"
method: GET
path: "/user/user_visits"
---

# Get user visits list

`GET /user/user_visits`

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

## Query parameters

- `user` string, required — Email or user GUID of the user whose visits you want to retrieve.
- `limit` integer — Number of visits to return (max 100).
- `offset` integer — Number of visits to skip for pagination.

## Headers

- `api_key` string, required — API key for authentication.

## Response `200`

User visits list retrieved successfully.

- object
  - `user_id` string — A unique identifier for the user.
  - `user_email` string — The user's email address.
  - `user_visits` object[] — Array of user visits
    - `id` string — Unique identifier of the visit
    - `created_at` string, date-time — Timestamp of the visit
    - `project_id` integer — Project identifier
    - `user_id` string — User identifier associated with the visit
    - `ip` string — User's IP address
    - `url` string — URL where the visit occurred
    - `user_agent` string — User's browser/device information
    - `is_first_visit` integer — Whether this is the user's first visit (1 for yes, 0 for no)
    - `visit_number` integer — Number of visits by the user
    - `first_visit_date` string, date-time — Date of user's first visit
    - `previous_visit_date` string, date-time, nullable — Date of user's previous visit
    - `user_platform` string — User's device platform
    - `user_language` string — User's preferred language
    - `user_country_code` string — User's country code
    - `user_state_code` string, nullable — User's state/province code
    - `user_city_name` string, nullable — User's city
    - `user_zip_code` string, nullable — User's zip code
    - `utm_source` string, nullable — UTM source parameter
    - `utm_medium` string, nullable — UTM medium parameter
    - `utm_campaign` string, nullable — UTM campaign parameter
    - `utm_content` string, nullable — UTM content parameter
    - `utm_term` string, nullable — UTM term parameter
    - `utm_ad_id` string, nullable — UTM ad ID parameter
    - `utm_adset` string, nullable — UTM adset parameter
    - `utm_adname` string, nullable — UTM ad name parameter
    - `utm_adset_id` string, nullable — UTM adset ID parameter
    - `utm_id` string, nullable — UTM ID parameter
    - `fbclid` string, nullable — Facebook click ID
    - `ttclid` string, nullable — TikTok click ID
    - `gbraid` string, nullable — Google Ads enhanced conversions parameter
    - `gclid` string, nullable — Google Ads click ID
    - `fbc` string, nullable — Facebook browser ID
  - `pagination` object — Pagination information
    - `limit` integer — Number of visits requested
    - `offset` integer — Number of visits skipped
    - `count` integer — Number of visits returned in this response

## Other responses

- `404` — User not found
- `422` — Invalid user parameter

---

[API](https://skmtc.net/web2wave/apis/web2wave-api.md) · [All operations](https://skmtc.net/web2wave/apis/web2wave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/web2wave/web2wave-api/versions/c88545119271/schema)