Skip to main content

​
HTTP Status Codes

StatusMeaningAction
200SuccessData returned in data object
402Payment RequiredExpected — x402 client pays and retries automatically
400Bad RequestMissing or empty address in request body
500Intel Fetch FailedAddress not geocoded or critical upstream failure — check address format
504Gateway TimeoutVercel 30s limit exceeded — upstream API was slow, retry

​
Partial data

PropX402 always returns a response even when individual sources fail. Failed sources return a note key instead of data: 
{
  "floodRisk": {
    "note": "FEMA API unavailable",
    "zone": null
  }
}
Only a geocoding failure (OpenStreetMap) produces a 500 error.

​
Rate limits

No hard rate limits — x402 payment is the natural rate limiter. Vercel serverless enforces a 30-second execution timeout. Bulk requests are capped at 20 addresses.

​
Address format tips

For best results, include full address with city, state, and zip: 
✅ "1411 8th Ave SE, Cedar Rapids, IA 52403"
⚠️  "1411 8th Ave SE"  ← may fail geocoding