Documentation menu
Errors
Error codes and how to handle them.
When a request fails, check the status code, then handle the code in the error body. Errors follow RFC 9457 and are sent as application/problem+json.
The error body
JSON
{
"type": "https://placestack.com/docs/api/error#parameter_invalid",
"title": "Invalid parameter",
"status": 422,
"detail": "size: Input should be less than or equal to 200",
"code": "parameter_invalid",
"field": "size",
"errors": [
{
"field": "size",
"detail": "Input should be less than or equal to 200"
}
],
"request_id": "req_4f1c9a0b7d2e5f8a1c3b6d90"
}typeA link to the code on this page.
titleA short name for the error. Fixed for each code.
statusThe HTTP status.
detailWhat went wrong, and how to fix it.
codeThe error code. Branch on this.
fieldThe invalid parameter, if any.
errorsEvery invalid parameter. Only on parameter_invalid.
request_idThe request id, also sent in the request-id header. Include it when contacting support.
Status codes
400The request is malformed.
401The API key is missing, invalid or expired. See Authentication.
402Your organization is out of credits. Add credits and retry. Nothing was charged.
403The key or plan doesn't allow this request. detail says whether it's the scope, the plan, or the credential type.
404No record has that id.
405The path doesn't support that method.
409The record changed since you read it. Read it again and retry.
422The request is well formed but can't be processed. code says why.
429Too many requests. Wait the number of seconds in Retry-After, then retry. Not charged.
501This operation is not available yet. Don't retry.
5xxSomething went wrong on Placestack's end. Check status.placestack.com, then retry.
Error codes
Credentials
credential_missingSend your API key as Authorization: Bearer <key>.
credential_invalidCheck the key was copied in full and hasn't been revoked.
credential_expiredCreate a new key and replace the old one.
Parameters
parameter_invalidFix the parameter named in field. detail says what it accepts. errors lists every invalid parameter.
field_unknownThe list can't be sorted or filtered by that field. detail lists the supported fields.
id_malformedThe id has the wrong prefix for this path, such as jur_ for a jurisdiction or prc_ for a parcel.
request_refusedThe request is malformed. detail says why.
Pages and sorting
cursor_expiredStart the list again without a cursor.
cursor_sort_mismatchSend the same sort you used for the first page, or start again without a cursor.
Records
no_such_resourceNo record has that id.
version_conflictThe record changed since you read it. Read it again and retry.
Plan and limits
scope_missingThe credential lacks the required scope, named in detail. Create a key with that scope, or reconnect your agent to grant it.
person_requiredAPI keys can't make this call. Sign in to the console instead.
api_key_not_acceptedAPI keys can't make this call. Use the console or the MCP server.
entitlement_missingYour plan doesn't include this. Upgrade to use it.
quota_exhaustedAdd credits, then send the request again.
rate_limitedWait the number of seconds in Retry-After, then retry.
method_not_allowedUse a method the path supports.
not_availableThis data is not available yet. Don't retry. Check coverage instead.