# RippleNet Server error codes

This document provides a list of error messages that RippleNet Server returns if it encounters a problem.

Developers and architects may find this useful for designing integration logic. Administrators and other users may find this useful for troubleshooting.

The error codes on this page represent service-level errors.

## Error groups

AUTH ("A", "auth")
CONFIGURATION ("C", "configuration")
ERROR ("E", "error")
FEES ("F", "fees")
LEDGER ("L", "ledger")
PAYMENTS ("PY", "payments")
QUOTING ("Q", "quoting")
RATES ("R", "rates")
RIPPLENET ("RN", "ripplenet")
VALIDATOR ("V", "validator")
XCURRENT ("XC", "xcurrent")

## Auth errors

| Error code | Error message |
|  --- | --- |
| A0110 | `NOT_AUTHORIZED_ERROR` |
| A0151 | `LOCK_USER` |
| A0155 | `LOCK_CLIENT_ID` |
| A0156 | `OAUTH_TOKEN_ENCRYPTION_ERROR` |
| A0160 | `RIPPLENET_MAX_CONCURRENT_SESSIONS_ERROR_CODE` |


## Configuration errors

| Error code | Error message |
|  --- | --- |
| C0001 | `PAYOUT_METHOD_NOT_FOUND` |
| C0002 | `PAYOUT_METHOD_ALREADY_EXISTS` |
| C0109 | `USER_NOT_FOUND_ERROR` |
| C0111 | `UI_ERROR` |
| C0116 | `NO_SYSTEM_CONFIGURATION_FOUND` |
| C0154 | `CLIENT_ID_NOT_FOUND_ERROR` |


## "Error" errors

| Error code | Error message |
|  --- | --- |
| E0101 | `RESOURCE_NOT_FOUND_PROBLEM` |
| E0104 | `JSON_PROCESSING_PROBLEM` |
| E0120 | `BAD_REQUEST_PROBLEM` |
| E0149 | `JSON_MALFORMED_PROBLEM` |
| E0150 | `INTERNAL_SERVER_PROBLEM` |
| E0154 | `HTTP_CLIENT_ERROR` |


## Fees errors

| Error code | Error message |
|  --- | --- |
| F0001 | `INVALID_CURRENCY` |
| F0002 | `INVALID_FEE_VALUE` |
| F0003 | `INVALID_FEE_LIMIT` |
| F0004 | `FEE_LIMIT_OVERLAP` |
| F0005 | `INVALID_FEE_ID` |
| F0006 | `MISSING_FEE_ID` |
| F0007 | `FEE_NOT_FOUND` |
| F0008 | `INVALID_PAYOUT_METHOD` |


## Ledger errors

| Error code | Error message |
|  --- | --- |
| L0000 | `ACCOUNT_NOT_FOUND` |
| L0001 | `MIN_BALANCE_VIOLATION` |
| L0002 | `MAX_BALANCE_VIOLATION` |
| L0003 | `INVALID_BALANCE_LIMIT` |
| L0004 | `MIN_MAX_BALANCE_VIOLATION` |
| L0005 | `INVALID_ROUNDING_MODE_FOR_ACCOUNT` |
| L0006 | `INVALID_ROLLBACK_ACTION` |
| L0007 | `INVALID_TRANSACTION_TYPE` |
| L0008 | `INVALID_TRANSACTION` |
| L0010 | `INVALID_ACCOUNT_NAME` |
| L0011 | `MISSING_RIPPLENET_ACCOUNT_TYPE` |
| L0012 | `INVALID_ACCOUNT_SCALE` |
| L0013 | `DISABLED_ACCOUNT` |


## Payments errors

| Error code | Error message |
|  --- | --- |
| PY0001 | `PAYMENT_NOT_FOUND` |
| PY0002 | `TRANSFER_NOT_FOUND` |
| PY0003 | `OBJECT_MAPPER_ERROR` |
| PY0004 | `INVALID_SENDER_ERROR` |
| PY0005 | `INVALID_RECEIVER_ERROR` |
| PY0006 | `CONTRACT_VALIDATION_ERROR` |
| PY0007 | `NO_LABLES_ERROR` |
| PY0010 | `INVALID_RETURN_PAYMENT_REQUEST` |
| PY0012 | `QUOTE_INELIGIBLE_TO_ACCEPT` |
| PY0013 | `INVALID_SCALE` |
| PY0014 | `INVALID_ACCOUNT` |
| PY0015 | `TRANSFER_INITIATOR_NOT_OWNER` |
| PY0016 | `INVALID_GET_PAYMENTS_REQUEST` |
| PY0017 | `CANNOT_SAVE_MULTIPLE_RN_INFO_OF_SAME_TYPE` |
| PY0020 | `RIPPLE_NET_INFO_VALUE_TOO_LARGE` |
| PY0022 | `INVALID_EXCHANGE_TRANSFER_REQUEST_PROBLEM` |
| PY0023 | `INVALID_REQUESTS_FOR_PAYMENT_REQUEST_PROBLEM` |
| PY0024 | `INVALID_QUOTE_HOP_USAGE_REPRORT_PROBLEM` |
| PY0025 | `INVALID_TRANSFER_ACTION_PROBLEM` |
| PY0026 | `QUOTE_EXPIRY_NOT_FOUND` |
| PY0027 | `QUOTE_EXPIRY_ALREADY_EXISTS` |
| PY0030 | `EXCHANGE_TRANSFER_INITIATOR_NOT_OWNER` |


## Quoting errors

| Error code | Error message |
|  --- | --- |
| Q0010 | `UNABLE_TO_CALCULATE` |
| Q0011 | `QUOTE_NOT_FOUND` |
| Q0012 | `INVALID_SCALE_IN_QUOTED_ACCOUNT` |
| Q0013 | `INVALID_ACCOUNT_IN_QUOTE` |
| Q0015 | `MISSING_REQUIRED_FIELD` |
| Q0017 | `UNABLE_TO_RETRIEVE_PREVIOUS_HOP` |
| Q0018 | `RATE_NOT_FOUND` |
| Q0019 | `INVALID_QUOTE_TYPE` |


## Rates errors

| Error code | Error message |
|  --- | --- |
| R0001 | `INVALID_RATE_LIMIT` |
| R0002 | `RATE_LIMIT_OVERLAP` |
| R0003 | `INVALID_RATE_ID` |
| R0004 | `SAME_BASE_COUNTER_CURRENCY_CODES` |
| R0005 | `NEGATIVE_RATE` |


## RippleNet errors

| Error code | Error message |
|  --- | --- |
| RN0000 | `UNAUTHORIZED` |
| RN0001 | `INVALID_SENDING_AMOUNT` |
| RN0002 | `INVALID_SENDING_FEE` |
| RN0003 | `INVALID_RECEIVING_AMOUNT` |
| RN0004 | `INVALID_RECEIVING_FEE` |
| RN0005 | `INVALID_QUOTE_ID` |
| RN0006 | `INVALID_FX_RATE` |
| RN0007 | `INVALID_BASE_CURRENCY` |
| RN0008 | `INVALID_COUNTER_CURRENCY` |
| RN0009 | `INVALID_RATE_TYPE` |
| RN0010 | `UNABLE_TO_CALCULATE` |
| RN0011 | `NO_QUOTE_PATH_FOUND` |
| RN0012 | `PAYMENT_NOT_FOUND` |
| RN0013 | `MESSAGE_PARSE_ERROR` |
| RN0014 | `MESSAGE_BODY_EMPTY` |
| RN0015 | `VALUE_SERIALIZATION_ERROR` |
| RN0016 | `UNAUTHORIZED_PAYMENT_STATE_ERROR` |
| RN0017 | `ILLEGAL_PAYMENT_STATE_ERROR` |
| RN0018 | `EXECUTION_FULFILLMENT_SIGNATURE_ERROR` |
| RN0019 | `OBJECT_MAPPER_ERROR` |
| RN0020 | `KEYSTORE_LOADING_ERROR` |
| RN0021 | `INVALID_LIQUIDITY_RELATIONSHIP_ERROR` |
| RN0022 | `PAYMENT_EXECUTION_ERROR` |
| RN0023 | `SERVER_ERROR` |
| RN0024 | `MESSAGE_MISSING_FIELDS_ERROR` |
| RN0025 | `PEER_NOT_FOUND` |
| RN0026 | `LIQUIDITY_PATH_ERROR` |
| RN0027 | `SETTLEMENT_EXECUTION_ERROR` |
| RN0028 | `INVALID_PAYMENT` |
| RN0029 | `INVALID_MESSAGE` |
| RN0030 | `PIPELINE_PROCESSING_PROBLEM` |
| RN0031 | `PAYMENT_QUOTE_EXPIRED_PROBLEM` |
| RN0032 | `PAYMENT_EXPIRED_PROBLEM` |
| RN0033 | `REQUEST_FOR_PAYMENT_NOT_FOUND_PROBLEM` |
| RN0034 | `REQUEST_FOR_PAYMENT_PROBLEM` |
| RN0035 | `RIPPLENET_CLIENT_HTTP_ERROR` |
| RN0036 | `RIPPLENET_CLIENT_IO_ERROR` |
| RN0037 | `REQUEST_FOR_PAYMENT_PATH_FINDING_ERROR` |
| RN0038 | `INVALID_CONTRACT_HASH_PROBLEM` |
| RN0039 | `INVALID_FAIL_PAYMENT_REQUEST` |
| RN0040 | `INVALID_QUOTE_ELEMENT` |
| RN0041 | `CANCELLATION_FULFILLMENT_SIGNATURE_ERROR` |
| RN0100 | `MESSAGE_PARSE_ERROR` |
| RN0101 | `MESSAGE_BODY_EMPTY_ERROR` |
| RN0102 | `INVALID_ACTION_ERROR` |
| RN0103 | `VALUE_SERIALIZATION_ERROR` |
| RN0104 | `JSON_PROCESSING_ERROR` |
| RN0105 | `UNEXPECTED_PIPELINE_ERROR` |
| RN0106 | `WEAK_PASSWORD_ERROR` |
| RN0107 | `CRYPTO_TRANSACTION_NOT_FOUND_IN_MESSAGE_ERROR` |
| RN0108 | `CRYPTO_TRANSACTION_NOT_FOUND_IN_VALIDATOR_ERROR` |
| RN0111 | `UI_ERROR` |
| RN0112 | `USER_DISABLED` |
| RN0113 | `EXECUTION_FULFILLMENT_SIGNATURE_ERROR` |
| RN0114 | `UNABLE_TO_FIND_PATH_ERROR` |
| RN0115 | `CRYPTO_TRANSACTION_STATE_INVALID_ERROR` |
| RN0116 | `QUOTE_INELIGIBLE_TO_ACCEPT` |
| RN0117 | `INVALID_RETURN_PAYMENT_REQUEST` |
| RN0118 | `CRYPTO_TRANSACTION_PROBLEM` |
| RN0119 | `QUOTING_PROBLEM` |
| RN0120 | `UNKNOWN_RIPPLENET_SETTLEMENT_PROBLEM` |
| RN0121 | `CRYPTO_TRANSACTION_EXPIRED_OR_CANCELED` |
| RN0122 | `INVALID_CRYPTO_TRANSACTION` |
| RN0123 | `MALFORMED_RESPONSE_MESSAGE` |
| RN0124 | `INVALID_LIQUIDITY_RELATIONSHIP_PROBLEM` |
| RN0125 | `LIQUIDITY_RELATIONSHIP_NOT_FOUND_PROBLEM` |
| RN0126 | `LIQUIDITY_PATH_NOT_FOUND_PROBLEM` |
| RN0127 | `INVALID_ACCOUNT_PROBLEM` |
| RN0128 | `INVALID_LIQUIDITY_PATH_PROBLEM` |
| RN0129 | `INVALID_TRANSFER_STATE_PROBLEM` |
| RN0130 | `CRYPTO_TRANSACTION_ID_MISSING` |
| RN0131 | `INVALID_OR_MISSING_MESSAGE_VALUE` |
| RN0132 | `INVALID_PAYMENT_METHOD_PROBLEM` |
| RN0133 | `ASYNC_MESSAGE_PROCESSING_PROBLEM` |
| RN0134 | `REQUEST_WAIT_TIMEOUT_PROBLEM` |
| RN0135 | `MESSAGE_FLOW_NOT_FOUND_PROBLEM` |
| RN0136 | `ROUTE_COLLECTION_NOT_FOUND_PROBLEM` |
| RN0137 | `JMS_EXCEPTION_PROBLEM` |
| RN0139 | `INVALID_TRANSFER_REQUEST_PROBLEM` |
| RN0140 | `INVALID_PUBLIC_KEY_PROBLEM` |
| RN0140 | `REMOTE_ACCOUNT_UPDATE_PROBLEM` |
| RN0141 | `INVALID_ACCOUNT_AMOUNT_PROBLEM` |
| RN0142 | `DUPLICATE_ACCOUNT_PROBLEM` |
| RN0142 | `GENERIC_INVALID_QUOTE_PROBLEM` |
| RN0143 | `ACCOUNT_CREATION_PROBLEM` |
| RN0144 | `ACCOUNT_UPDATE_PROBLEM` |
| RN0145 | `GENERIC_INVALID_PAYMENT_PROBLEM` |
| RN0145 | `STATEMENT_DATA_ERROR` |
| RN0146 | `REMOTE_ACCOUNT_STATEMENT_PROBLEM` |
| RN0147 | `REMOTE_HOST_CONNECTION_PROBLEM` |
| RN0153 | `LIQUIDITY_PATH_INVALID_OPERATION_PROBLEM` |
| RN0302 | `PAYMENT_RESTART_INCOMPATIBLE_ENTITY_STATE_PROLEM` |
| RN0303 | `UUID_PARAMETER_INVALID_PROBLEM` |
| RN0304 | `DATE_PARAMETER_INVALID_PROBLEM` |
| RN9999 | `UNKNOWN` |


## Validator errors

| Error code | Error message |
|  --- | --- |
| V0001 | `CRYPTO_TX_ID_INVALID` |
| V0002 | `CRYPTO_TX_EXISTS` |
| V0003 | `CRYPTO_TX_COST_TOO_HIGH` |
| V0004 | `FULFILLMENT_REQUIRED` |
| V0005 | `CRYPTO_TX_FINALIZED` |
| V0010 | `INVALID_EXECUTION_FULFILLMENT` |
| V0011 | `INVALID_CANCELLATION_FULFILLMENT` |
| V0012 | `CRYPTO_TX_EXPIRED` |
| V0020 | `CRYPTO_TX_NOT_FOUND` |


## "xCurrent" errors

| Error code | Error message |
|  --- | --- |
| XC0100 | `MESSAGE_PARSE_ERROR` |
| XC0132 | `REMOTE_RESPONSE_SERIALISATION_PROBLEM` |
| XC0133 | `USAGE_REPORT_REQUEST_PROBLEM` |
| XC0135 | `USAGE_REPORT_SEND_PROBLEM` |
| XC0139 | `ROUTING_ERROR_IN_PIPELINE` |
| XC0147 | `INVALID_LEDGER_CLIENT_REQUEST_PROBLEM` |
| XC0150 | `INTERNAL_SERVER_PROBLEM` |
| XC0157 | `INVALID_SYSTEM_SETTINGS` |
| XC0158 | `USAGE_REPORT_GENERATION_PROBLEM` |
| XC0159 | `NO_MAIL_SERVER_CONFIGURED_PROBLEM` |