{"uid":"cap_6W8vixjAF--093N_HqShg","slug":"compliapi-geo-sanctions-screening-by-ip-a263cf57","name":"CompliAPI Geo & Sanctions Screening by IP","description":"Easy OFAC sanction list lookups, geo-fencing checks and VPN detection, streamlining compliance obligations around the world.","url":"https://api.compliapi.com/api/v1/geo/%7Bip_address%7D","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"},"pathParams":{"type":"object","required":["ip_address"],"properties":{"ip_address":{"type":"string","description":"IPv4 or IPv6 address"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"ip":"8.8.8.8","city":"Mountain View","region":"California","country":"US","sanctioned":false,"source_url":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XfVYCJH1EggVvoWrQh-v3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Looks up geolocation data and OFAC sanctions status for a given IP address, returning city, region, country, and whether the location is sanctioned.","exampleAgentPrompt":"Before processing this transaction, check if the IP address 203.0.113.45 is from a sanctioned country or OFAC-restricted region using CompliAPI's geo sanctions screening.","exampleUseCases":[{"title":"Block sanctioned-country signups","prompt":"A user with IP 185.220.101.12 just tried to register on our platform — can you check if that IP is geolocated in a sanctioned or OFAC-embargoed country before we let them proceed?"},{"title":"Compliance check before payment processing","prompt":"We're about to process a payment from a customer whose IP is 91.108.4.0 — run a sanctions screening on that IP to confirm the country isn't on any OFAC embargo list."},{"title":"Geo-fence API access by jurisdiction","prompt":"Someone from IP 5.61.32.100 is hitting our API — tell me their country and whether that location is considered sanctioned so I can decide whether to allow or block the request."}],"resultDescription":"Returns a JSON object with the IP address, resolved city, region, and country, plus a boolean 'sanctioned' field indicating OFAC or other sanctions designation, and an optional source_url referencing the sanctions list entry if applicable.","failureModes":["Invalid or malformed IP address returns an error response","Private or reserved IP ranges (e.g. 192.168.x.x) may return incomplete geo data","IP not found in geolocation database may return null city/region","Sanctions list may not be fully up-to-date in real time","IPv6 addresses may have less precise geolocation coverage","Network timeout or upstream database unavailability"],"whenToPreferThis":"Choose this endpoint when you need a single API call that combines both IP geolocation and OFAC sanctions status in one response, rather than making separate calls for geo-lookup and sanctions screening. Ideal for real-time compliance checks at transaction or registration time where you need to know both where a user is and whether that location is restricted.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:30:35.540Z","isFirstParty":false}