{"uid":"cap_qPZGjREtlKfNXXcY5SmNR","slug":"ip-country-bulk-730cc8aa","name":"ip-country-bulk","description":"Bulk ip country: up to 20 ips in one call, processed concurrently, results returned in input order with a per-item error field and a count of failures. Same answer per item as the single /ip/geo endpoint (IP to country). Batch enrichment for agents that hold a list. $0.01 per batch.","url":"https://intel.rallylive.ca/bulk/ip/geo","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n_m7Cg_h_b_tLBFF1rBfU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves up to 20 IP addresses to their country/geo data in a single concurrent batch call, returning results in input order with per-item error fields.","exampleAgentPrompt":"I have a list of IP addresses — 203.0.113.5, 198.51.100.12, 192.0.2.77, and 104.21.44.1 — can you look up the country for all of them at once and tell me if any failed?","exampleUseCases":[{"title":"Security log country enrichment","prompt":"I've got a batch of suspicious IP addresses from our access logs — 185.220.101.1, 45.33.32.156, 103.21.244.0, 198.199.82.196, and 91.108.4.1 — can you geolocate all of them and tell me which countries they're coming from, including any that couldn't be resolved?"},{"title":"Audience analytics by country","prompt":"We collected 15 IP addresses from signups today — here they are: 8.8.8.8, 1.1.1.1, 9.9.9.9, 208.67.222.222, 76.76.19.19, 94.140.14.14, 4.2.2.2, 64.6.64.6, 185.228.168.9, 198.54.117.10, 199.85.126.10, 209.244.0.3, 216.146.35.35, 37.235.1.174, 8.26.56.26 — look up what countries they're all from so I can understand our user geography."},{"title":"Rate limiting by region","prompt":"Can you batch geolocate these IPs for me — 103.86.96.100, 5.188.86.172, 45.95.168.1, 23.129.64.100, 171.25.193.9, 199.249.230.87, 162.247.72.201, 185.100.85.101 — I need to know which countries they resolve to so I can apply the right regional rate limits."}],"resultDescription":"An ordered array of geolocation results (one per input IP) matching the order of the input list. Each item contains country and geo data equivalent to the single /ip/geo endpoint response, plus a per-item error field if that IP could not be resolved. A summary failure count is also returned for the batch.","failureModes":["Invalid or malformed IP address in input list returns a per-item error rather than failing the whole batch","More than 20 IPs submitted may result in rejection or truncation","Private/reserved IP ranges (e.g. 10.x.x.x, 192.168.x.x) may return no country data with an error flag","Payment failure (x402) if USDC balance is insufficient","Network timeout if upstream geo data source is unavailable","Empty input list returns an error or empty results array"],"whenToPreferThis":"Choose this endpoint when you have multiple IP addresses (2–20) to geolocate and want to minimize round trips and cost — it processes all IPs concurrently and returns results in input order, making it ideal for batch enrichment pipelines, log analysis, or analytics jobs. For a single IP, prefer the single /ip/geo endpoint to avoid unnecessary overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:21:56.701Z","isFirstParty":false}