Error Reference

Overview

When an error occurs, Pave Bank returns an HTTP status code that indicates the error type:

Code	Status	What it means
400	Bad Request	Request contains invalid data or is missing required information
401	Unauthorized	Authentication token is missing, invalid, or expired
403	Permision Denied	Insufficient permissions to perform this action
404	Not Found	The requested resource does not exist
409	Conflict	Request conflicts with an existing operation (e.g., duplicate idempotency key)
429	Too Many Requests	Rate limit has been exceeded for this API
500	Internal Server Error	An internal server error occurred; retry or contact support

All error responses follow this structure:

{
    "error": {
        "code": "<HTTP_STATUS_CODE>",
        "status": "<ERROR_STATUS>",
        "message": "<ERROR_MESSAGE>"
    }
}