Error codes you may come across and their meaning. We work hard to ensure you don't need this page often.
All error responses have the same response body structure.
msg
string
A human-readable message providing you details about the error. Typically, these error can be shown to end users.
Picket uses conventional HTTP response codes to indicate the success or failure of an API request. In general, codes in the
2xx range indicate success
4xx range indicate an error that failed given the request parameters (required parameter was omitted, invalid wallet address format, etc)
5xx range indicate an error with Picket's servers.
200 - OK
Everything worked as expected.
400 - Bad Request
The request was not formed as expected, often due to missing a required parameter.
401 - Unauthorized
No valid API key provided.
404 - Not Found
The requested resource doesn't exist.
409 - Conflict
The request conflicts with another request
424 - Failed Dependency
Upstream failure (potentially due to an upstream node provider)
429 - Too Many Requests
You hit us with more requests than expected. We recommend you space our your requests
500, 502, 503, 504 - Server Errors
Something went wrong on Picket's end. (We're in beta.)
When an error can be handle programmatically, the response will include an error code—a short enumerable string—as a value for the code attribute. Below are a list of possible error code values
account_exists
There is already an account associated with the given wallet address
api_key_invalid
The provided API key is invalid, likely because it doesn't exist or the authorization header is malformed
authentication_required
The request is missing the required authentication header
parameter_invalid
One or more provided parameters are malformed
resource_not_found
The requested resource is not found. This can occur when the resource doesn't exist or you do not have permission to view the resource
permission_denied
The user lacks permission, or token ownership
parameter_missing
One or more required parameter values are missing
Last updated
