Invalid filter
Resolution: use fields and operators listed by GET /v1/field-catalog.
Stable problem codes · clear recovery
PremiumPin API Errors
Every API problem includes a stable code, request ID, and resolution hint. Preserve the request ID when an error repeats.
Problem catalog
Scope required
Resolution: provide county FIPS, one state, or held-all scope.
Scope too broad
Resolution: narrow the geography or result limit.
Unknown field
Resolution: choose a public canonical field.
Bad cursor
Resolution: restart pagination without the cursor.
Cursor expired
Resolution: restart against the current store version.
Unauthorized
Resolution: sign in or send a valid Bearer credential.
Quota exceeded
Resolution: wait for the UTC-month reset or open the upgrade link.
Not entitled
Resolution: use an entitled account or remove restricted fields.
Rate limited
Resolution: wait for Retry-After before retrying.
Not found
Resolution: verify the route or parcel key.
Method not allowed
Resolution: use the method in the OpenAPI contract.
HTTP error
Resolution: follow the response hint and include request_id in support mail.
Internal server error
Resolution: retry once, then email support@premiumpin.com with the request_id if it repeats.