Errors & limits
Status codes, quota, cache TTLs.
Status codes
| Status | Meaning |
|---|---|
401 | Missing or invalid API key. |
400 | Private or malformed IP, mixed starters, or invalid ZIP, coordinates, place, or address. |
404 | No data for that geography. |
402 | Trial expired, or the paid subscription is no longer active. |
429 | Monthly quota exceeded. |
502 | Geolocation lookup failed. |
503 | Demographics or jobs unavailable. |
Quota
7-day trial: 1,000 successful calls. Then one paid plan. Successful responses count. 4xx and 5xx do not. See pricing.
Caching
Geo: 7 days. Demographics, enrichment, LODES: 30 days, keyed by geography and id. Cached hits count.