Get Visit Logs

Retrieve paginated visit logs for a specific short link with date range filtering.

Endpoint

GET /v2/external/client/analytics/visit-logs

Query Parameters

Parameter	Type	Required	Default	Description
shortUrl	string	Yes	-	Short URL identifier
startDate	string	Yes	-	Start date (YYYY-MM-DD)
endDate	string	Yes	-	End date (YYYY-MM-DD)
page	integer	No	1	Page number (1-based)
pageSize	integer	No	10	Number of items per page

Response

{
  "status": true,
  "message": "Visit logs fetched successfully",
  "data": {
    "content": [
      {
        "id": "507f1f77bcf86cd799439011",
        "shortUrl": "abc123",
        "ipAddress": "192.168.1.1",
        "countryCode": "US",
        "countryName": "United States",
        "city": "New York",
        "browserName": "Chrome",
        "browserVersion": "120.0",
        "osName": "Windows",
        "osVersion": "11",
        "deviceType": "Desktop",
        "deviceBrand": "Dell",
        "deviceModel": "XPS 13",
        "utmSource": "google",
        "utmMedium": "cpc",
        "utmCampaign": "summer-sale",
        "createdAt": "2024-01-15T10:30:00Z"
      }
    ],
    "totalElements": 1250,
    "totalPages": 125,
    "size": 10,
    "number": 0,
    "first": true,
    "last": false
  }
}

Notes

• Date range is inclusive
• Results are sorted by creation date (newest first)
• Data retention limits apply - requests for data beyond your plan's retention period will return an error
• Results are cached for 1 hour