{"uid":"cap_xanZQLSp9wcWUkjJHgS6F","slug":"statepulse-location-verify-presence-15cc93aa","name":"StatePulse Location Verify-Presence","description":"Validates an IP address's physical route and latency offsets to verify country compliance, returning a cryptographically signed Geolocation Certificate. Matches: geolocate ip check, secure location verification, ip route validator, compliant network geodata.","url":"https://statepulse-api.hahavoid0.workers.dev/location/verify-presence","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"type":"json","example":{"result":{"ip":"8.8.8.8","status":"VERIFIED","actual_country":"US","certificate_id":"cert_9844-9c97-43e4-8e0d","expected_country":"US","signed_verification_proof":"0xmocksignatureprovingstatepulselocationcheck"},"supported":true,"confidence":"high"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_llFb3LL1alo9gJC-rbqlo","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies that an IP address is physically present in an expected country and returns a signed cryptographic proof of the location check","exampleAgentPrompt":"Can you verify that the IP address 8.8.8.8 is actually located in the United States and give me a signed proof certificate I can use to confirm it?","exampleUseCases":null,"resultDescription":"A JSON object containing the queried IP, a VERIFIED or FAILED status, the actual detected country code, the expected country code, a unique certificate ID, a signed cryptographic proof string attesting to the location check result, and a confidence level (high/medium/low).","failureModes":["IP address not routable or invalid format — returns error or unsupported:true with no result","Country mismatch — status is not VERIFIED, actual_country differs from expected_country","Payment failure — x402 USDC payment on Base rejected or insufficient","Service unavailable — Cloudflare Worker timeout or cold start failure","Unknown IP geolocation — confidence returned as low with uncertain result"],"whenToPreferThis":"Choose this endpoint when you need a cryptographically signed, verifiable attestation that an IP address corresponds to a specific country — not just a raw geolocation lookup. Ideal for compliance workflows, access control enforcement, or audit trails where a machine-readable proof certificate is required alongside the geolocation result.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:46:11.271Z","isFirstParty":false}