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
https://api.castle.io/v1/ips/query Request body
ips | 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. | ||||||||||||||||||||||||||||||||