API Errors
You may encounter error messages when interacting with Pinwheel's RESTful API.
Looking for a different category of errors?
Pinwheel's system also communicates Job Errors and Link SDK Errors.
These errors are returned in JSON format inside an error object. The type
field contains a higher level category of the error and the code
field is more specific. The message
field contains a human-readable description of the error and is subject to change. For example, an error response to POST /link_tokens
could look like:
{
"error": {
"type": "INVALID_REQUEST_PARAMETERS",
"code": "INVALID_ROUTING_NUMBER",
"message": "Validation error.",
"status_code": 400,
"fields": [{
"message": "Provided value doesn't match valid format.",
"name": "routing_number"
}]
}
}
There are four different API error types:
Error Type | Description |
---|---|
INVALID_REQUEST_PARAMETERS | A request was invalid. |
RECORD_NOT_FOUND | A requested record could not be found. |
UNAUTHORIZED_REQUEST | A request was unauthorized. |
UNKNOWN_ERROR | An unknown error occurred. |
The optional fields
attribute holds an array of validation errors. It is human-facing and shouldn't be programatically processed since its structure and content may change arbitrarily. Use type
and code
as stable fields for programmatic handling.
Please contact [email protected] for access to our Dashboard.
Updated 4 months ago