---
title: "Summarize IP addresses."
method: POST
path: "/tools/summarize-ips"
tags: ["general"]
---

# Summarize IP addresses.

`POST /tools/summarize-ips`

## Request

- Base URL: `https://ipinfo.io`
- URL: `https://ipinfo.io/tools/summarize-ips`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
  - API key in query parameter `token`
- TypeScript: <https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification/docs/tools/summarize-ips/post.ts> (a function with typed inputs; its response is checked against the schema)

Get summary-level information of upto 500,000 IP addresses, including IP location on a map, IP types, privacy detection flags, top ASNs, top cities, and more. [Explore the IPinfo Summarize tool](https://ipinfo.io/tools/summarize-ips).

## Query parameters

- `cli` integer

## Request body `text/plain`

- string

## Response `200`

Summarize response object.

- object

## Other responses

- `422`: The input payload does not meet the specification.
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification.md) - [All operations](https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/ipinfo/apis/ipinfo-io-openapi-specification/revisions/c63f11e4f26e?raw)