---
title: "Retrieve top user sessions"
method: GET
path: "/waap/v1/ip-info/top-sessions"
tags: ["IP Spotlight"]
---

# Retrieve top user sessions

`GET /waap/v1/ip-info/top-sessions`

Obtain the top 10 user sessions interfacing with a particular domain, identified by IP.

## Query parameters

- `ip` union, required — The IP address to check
  - string, ipv4
  - string, ipv6
- `domain_id` integer, required — The identifier for a domain. When specified, the response will exclusively contain data pertinent to the indicated domain, filtering out information from other domains.

## Response `200`

Successful Response

- TopSession[]
  - `session_id` string, uuid, required — The session ID
  - `duration` number, required — The duration of the session in seconds
  - `requests` integer, required — The number of requests in the session
  - `blocked` integer, required — The number of blocked requests in the session
  - `start_time` string, date-time, required — The start time of the session as a POSIX timestamp

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Unauthenticated
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)