---
title: "Fetch request and session metrics for a given IP address (and optionally a domain)"
method: GET
path: "/waap/v1/ip-info/counts"
tags: ["IP Spotlight"]
---

# Fetch request and session metrics for a given IP address (and optionally a domain)

`GET /waap/v1/ip-info/counts`

Retrieve metrics encompassing the counts of total requests, blocked requests and unique sessions associated with a specified IP address. Metrics provide a statistical overview, aiding in analyzing the interaction and access patterns of the IP address in context.

## Query parameters

- `ip` union, required — The IP address to check
  - string, ipv4
  - string, ipv6
- `domain_id` integer, nullable — 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

- IpInfoCounts
  - `total_requests` integer, required — The total number of requests made by the IP address
  - `blocked_requests` integer, required — The number of requests from the IP address that were blocked
  - `unique_sessions` integer, required — The number of unique sessions from the IP address

## 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)