HomeGuidesAPI Reference
API Reference

Get source IP statistics for allowed or denied URL access events.

Retrieves source IP addresses associated with allowed or denied URL access events from Secure Web Services. The endpoint filters data by appliances, URLs, and categories to provide detailed source IP statistics over time. Requires READ or READ_WRITE role permissions.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
int64
required
≥ 0

Unix epoch timestamp (in seconds) marking the start of the time range. Must be a positive integer less than endTime.

int64
required
≥ 0

Unix epoch timestamp (in seconds) marking the end of the time range. Must be greater than startTime.

string
enum
required

Time aggregation interval for the statistics data. Determines how data points are grouped.

Allowed:
boolean
required

Filter for URL access status. Set to true to retrieve allowed URLs, false for denied URLs.

integer
≤ 50
Defaults to 50

Maximum number of results to return. Limits the result set size for performance optimization.

Body Params

Request body containing appliance IDs, URL, and category filters for retrieving source IP statistics.

Request payload for retrieving source IP statistics associated with URL access events.

nePks
array of objects
required

List of appliance identifiers (nePks).

nePks*
url
array of strings
required
length ≥ 1

Array of URL patterns to filter. Only the first URL in the array is used for filtering.

url*

URL or domain name to filter on.

category
array of strings
required
length ≥ 1

Array of web content categories to filter. Only the first category in the array is used for filtering.

category*

Web content category name (e.g., Social Media, News, Entertainment).

Responses

401

Unauthorized - Authentication credentials are missing or invalid.

403

Forbidden - User lacks READ or READ_WRITE role permissions.

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json