# Get IP reports

**GET /accounts/{account_id}/reports/ips**

Fetch reports for the observed IP addresses in the given period

Available on: 
![AuditGUARD](https://storage.googleapis.com/clickguard-storage-dev/public/assets/api-docs/audit-off.png) ![AlertGUARD](https://storage.googleapis.com/clickguard-storage-dev/public/assets/api-docs/active-off.png) ![PremiumGUARD](https://storage.googleapis.com/clickguard-storage-dev/public/assets/api-docs/premium-on.png) ![EliteGUARD](https://storage.googleapis.com/clickguard-storage-dev/public/assets/api-docs/elite-on.png)



## Servers



## Parameters

### Path parameters
- **account_id** (string)
  ID of an account

### Query parameters
- **period** (string)
  Observed period for the report
- **sort** (string)
  Sort the IPs by a specified parameter. Use '-' prefix to indicate a descending sort. Default: '-total_clicks'.
- **offset** (number)
  Paginating parameter. Offset the result by a specified number. Default: 0.
- **limit** (number)
  Paginating parameter. Limit the number of result by a specified number. Max: 100. Default: 50.
- **query** (string)
  Search IPs by given query
- **ips[]** (array[string])
  Fetch all IP reports for the given array of IP addresses.
- **status** (string)
  Status of an IP address


## Responses
### 200
Successful operation

#### Body:  (array[object])
- **ip** (string)
  IP address
- **ip_type** (number)
  Version of the IP address, can be 4 or 6
- **status** (string)
  The current status of the IP address
- **total_clicks** (number)
  Total number of clicks from this IP
- **normal_clicks** (number)
  Total number of normal clicks from this IP
- **suspicious_clicks** (number)
  Total number of suspicious clicks from this IP
- **flagged_clicks** (number)
  Total number of flagged clicks from this IP
- **invalid_clicks** (number)
  Total number of invalid clicks from this IP
- **first_seen** (string(date-time))
  Timestamp of the first occurrence of this IP
- **last_seen** (string(date-time))
  Timestamp of the last occurrence of this IP
- **last_campaign_id** (string)
  The ID of the last campaign this IP interacted with
- **last_device_id** (string)
  The ID of the last device this IP was reported with
- **last_country** (string)
  The last country this IP was reported from
- **last_city** (string)
  The last city this IP was reported from


[Powered by Bump.sh](https://bump.sh)