# StatePulse Location Verify-Presence

> StatePulse Location Verify-Presence is a paid API for AI agents from statepulse-api.hahavoid0.workers.dev, paid per call via x402, $0.5/call, status unknown (last checked 2026-09-15).

Verifies that an IP address is physically present in an expected country and returns a signed cryptographic proof of the location check

## Facts

- Endpoint: POST https://statepulse-api.hahavoid0.workers.dev/location/verify-presence
- Price: $0.5/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/statepulse-location-verify-presence-15cc93aa
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xanZQLSp9wcWUkjJHgS6F

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability statepulse-location-verify-presence-15cc93aa -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/statepulse-location-verify-presence-15cc93aa/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from statepulse-api.hahavoid0.workers.dev](https://www.zero.xyz/host/statepulse-api.hahavoid0.workers.dev/llms.txt)