Skip to content
Browse API reference

Look up IPs in a batch

Batch equivalent of GET /v1/ips/{value}. Accepts 1-1000 IP addresses, silently deduplicates and drops unparseable inputs, and returns one intelligence record per valid, unique input. meta.total and meta.valid let callers detect input hygiene issues.

Request

POST https://api.castle.io/v1/ips/query

Request body

ips
required
string[]

1-1000 IP addresses to look up. Duplicates and unparseable entries are silently dropped before processing.

Response

200
object

Batch results plus dedup/validity counters.

401
No body

You are missing the Authorization header, or the API secret is missing or incorrect.

403
No body

The request is rejected because the service is not enabled for this account.

422
object

The request body is unprocessable by the API. Make sure it conforms to the specified format for the endpoint.

429
No body

You performed too many requests. You should back off and retry using the exponential backoff algorithm.

500
No body

There’s an issue on our end.