Skip to main content
POST
Batch IP Lookup

Request contract

  • Method and path: POST /apis/v1/ipinfo-io/batch-lookup
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/ipinfo-io/batch-lookup
  • Runtime facts: c5f1ee802daf768ef5fe3c42d02deae8d5355c4326d7d76583ac17fa6072c58a
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.0005 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.0005
  • Declared unit rate (USD): 1e-06
  • Billing unit: provider_credit
  • Cost contract: response_units
  • Published reference multiplier: 1.0
  • Declared maximum count/units: 10000000
  • Settlement evidence source: response_body

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
ips
string[]
required

List of 1 to 1000 IP addresses. Managed execution accepts only distinct bare IPv4 or IPv6 addresses, with one lookup charged per entry. BYOK also supports URL patterns. For free tier tokens, prefix IPs with 'lite/' (e.g., 'lite/8.8.8.8'). Supports field extraction patterns like 'lite/8.8.8.8/country' or 'lite/8.8.8.8/asn'. IPv4 and IPv6 addresses are both supported.

Required array length: 1 - 100 elements
filter
boolean
default:false

When True, entries with null responses are omitted from results. Useful for filtering out invalid IPs.

Response

Tool result data

{key}