logo

Errors

400 Bad Request

Bad Request

Response Schema: application/vnd.api+json
required
Array of objects (ErrorBadRequestError)

A list of errors that occurred.

Array
status
required
string

The HTTP status code for the error.

Example: "400"
detail
required
string

A message that explains the meaning of the error code. Developers are advised not to make programmatic use of this value, as it may change

Example: "The request failed because it was not in the correct format or did not contain valid data."
required
object

A list of links to resources that may be helpful in resolving the error.

required
object

Additional information about the error.

code
required
string

A code that indicates what went wrong.

Enum Value Description
INVALID_USER_INPUT

Missing or invalid request parameters provided

INVALID_VERSION_HEADER

Request contained an API version header that is not supported

INVALID_IDEMPOTENCY_KEY

Idempotency key is missing or was used for a dissimilar request.

Example: "INVALID_USER_INPUT"
application/vnd.api+json
{
  • "errors": [
    • {
      • "status": "400",
      • "detail": "The request failed because it was not in the correct format or did not contain valid data.",
      • "links": {},
      • "meta": {
        • "request_id": "3c526bf4-f3c0-4c4a-a4cb-95f7db8b3bbe",
        • "trace_id": "4016616108459136584"
        },
      • "code": "INVALID_USER_INPUT"
      }
    ]
}

400 Unprocessable Account

Unprocessable entity

Response Schema: application/vnd.api+json
required
Array of objects (ErrorUnprocessableAccountError)

A list of errors that occurred.

Array
status
required
string

The HTTP status code for the error.

Example: "400"
detail
required
string

A message that explains the meaning of the error code. Developers are advised not to make programmatic use of this value, as it may change

Example: "The request failed because it was not in the correct format or did not contain valid data."
required
object

A list of links to resources that may be helpful in resolving the error.

required
object

Additional information about the error.

code
required
string

A code that indicates what went wrong.

Enum Value Description
ACCOUNT_TYPE_INVALID

Provided account type is not one of DEPOSITORY or CARD

ACCOUNT_SUBTYPE_INVALID

Provided subtype is not one of CHECKING SAVINGS DEBIT GALILEO WISELY

ACCOUNT_TYPE_SUBTYPE_MISMATCH

The provided account subtype is not supported on the provided account type

DEBIT_CARD_CREATION_BLOCKED

Debit card creation blocked for this bin number

BANK_ACCOUNT_CREATION_BLOCKED

Bank account creation blocked for accounts with this routing number and first four digits of account number

DUPLICATE_ACCOUNT

Provided input matches an already existing account

INVALID_GALILEO_TOKEN_DATA

Provided Galileo token is invalid

INVALID_DEBIT_CARD

Provided debit card is invalid

INVALID_CARD_TOKEN

Provided card token is invalid

MISSING_REQUIRED_FIELD

Required field was not provided

INVALID_FIELDS

Input contains invalid fields not covered by other error codes

Example: "INVALID_FIELDS"
application/vnd.api+json
{
  • "errors": [
    • {
      • "status": "400",
      • "detail": "The request failed because it was not in the correct format or did not contain valid data.",
      • "links": {},
      • "meta": {
        • "request_id": "3c526bf4-f3c0-4c4a-a4cb-95f7db8b3bbe",
        • "trace_id": "4016616108459136584"
        },
      • "code": "INVALID_FIELDS"
      }
    ]
}

400 Unprocessable Transfer

Unprocessable entity

Response Schema: application/vnd.api+json
required
Array of objects (ErrorUnprocessableTransferError)

A list of errors that occurred.

Array
status
required
string

The HTTP status code for the error.

Example: "400"
detail
required
string

A message that explains the meaning of the error code. Developers are advised not to make programmatic use of this value, as it may change

Example: "The request failed because it was not in the correct format or did not contain valid data."
required
object

A list of links to resources that may be helpful in resolving the error.

required
object

Additional information about the error.

code
required
string

A code that indicates what went wrong.

Enum Value Description
MISSING_DEFAULT_DEPOSITORY_ACCOUNT

A default bank account must be set for a user before that user has the ability to make transfers

INVALID_ORIGIN

The provided origin must reference an earning balance account

INVALID_DESINATION_LINK

The provided destination link must reference an existing transfer account

INVALID_TRANSFER_SCHEDULE

The provided schedule for requested transfer is invalid for destination account

INVALID_CURRENCY

Provided currency value was formatted incorrectly

MINIMUM_AMOUNT_SUBCEEDED

The requested transfer amount was less than the minimum amount set for this provider. Generaly $5

EARNINGS_BALANCE_EXCEEDED

The requested transfer amount was greater than the user's current earnings balance

TRANSFER_LIMIT_EXCEEDED

The number of transfers requested within the last 24 hours exceeded the daily transfer limit for associated user

TRANSFER_AMOUNT_LIMIT_EXCEEDED

The amount requested within the last 24 hours exceeded the daily limit for associated user

INVALID_RESOURCE_STATE

Unable to process transfer due to the resource is in an invalid state.

INELIGIBLE_ORIGIN

The origin specified is not eligible for transfers at this time.

INVALID_TRANSFER_ID

Provided transfer id is not a valid uuid

DUPLICATE_TRANSFER_ID

Provided transfer_id is not unique and matches an existing transfer

Example: "INVALID_ORIGIN"
application/vnd.api+json
{
  • "errors": [
    • {
      • "status": "400",
      • "detail": "The request failed because it was not in the correct format or did not contain valid data.",
      • "links": {},
      • "meta": {
        • "request_id": "3c526bf4-f3c0-4c4a-a4cb-95f7db8b3bbe",
        • "trace_id": "4016616108459136584"
        },
      • "code": "INVALID_ORIGIN"
      }
    ]
}

401 Unauthorized

Invalid authentication credentials

Response Schema: application/vnd.api+json
required
Array of objects (ErrorUnauthorizedError)

A list of errors that occurred.

Array
status
required
string

The HTTP status code for the error.

Example: "400"
detail
required
string

A message that explains the meaning of the error code. Developers are advised not to make programmatic use of this value, as it may change

Example: "The request failed because it was not in the correct format or did not contain valid data."
required
object

A list of links to resources that may be helpful in resolving the error.

required
object

Additional information about the error.

code
required
string

A code that indicates what went wrong.

Enum Value Description
INVALID_TOKEN

Provided token is missing, expired, revoked, or otherwise invalid.

UNAUTHORIZED

Authentication has not been provided or is invalid.

Example: "INVALID_TOKEN"
application/vnd.api+json
{
  • "errors": [
    • {
      • "status": "400",
      • "detail": "The request failed because it was not in the correct format or did not contain valid data.",
      • "links": {},
      • "meta": {
        • "request_id": "3c526bf4-f3c0-4c4a-a4cb-95f7db8b3bbe",
        • "trace_id": "4016616108459136584"
        },
      • "code": "INVALID_TOKEN"
      }
    ]
}

403 Forbidden

Not authorized to perform this operation

Response Schema: application/vnd.api+json
required
Array of objects (ErrorForbiddenError)

A list of errors that occurred.

Array
status
required
string

The HTTP status code for the error.

Example: "400"
detail
required
string

A message that explains the meaning of the error code. Developers are advised not to make programmatic use of this value, as it may change

Example: "The request failed because it was not in the correct format or did not contain valid data."
required
object

A list of links to resources that may be helpful in resolving the error.

required
object

Additional information about the error.

code
required
string

A code that indicates what went wrong.

Value Description
FORBIDDEN

Requester is not allowed to access this resource or endpoint

Example: "FORBIDDEN"
application/vnd.api+json
{
  • "errors": [
    • {
      • "status": "400",
      • "detail": "The request failed because it was not in the correct format or did not contain valid data.",
      • "links": {},
      • "meta": {
        • "request_id": "3c526bf4-f3c0-4c4a-a4cb-95f7db8b3bbe",
        • "trace_id": "4016616108459136584"
        },
      • "code": "FORBIDDEN"
      }
    ]
}

404 Not Found

Resource was not found

Response Schema: application/vnd.api+json
required
Array of objects (ErrorNotFoundError)

A list of errors that occurred.

Array
status
required
string

The HTTP status code for the error.

Example: "400"
detail
required
string

A message that explains the meaning of the error code. Developers are advised not to make programmatic use of this value, as it may change

Example: "The request failed because it was not in the correct format or did not contain valid data."
required
object

A list of links to resources that may be helpful in resolving the error.

required
object

Additional information about the error.

code
required
string

A code that indicates what went wrong.

Value Description
RECORD_NOT_FOUND

Could not find a record with the provided ID

Example: "RECORD_NOT_FOUND"
application/vnd.api+json
{
  • "errors": [
    • {
      • "status": "400",
      • "detail": "The request failed because it was not in the correct format or did not contain valid data.",
      • "links": {},
      • "meta": {
        • "request_id": "3c526bf4-f3c0-4c4a-a4cb-95f7db8b3bbe",
        • "trace_id": "4016616108459136584"
        },
      • "code": "RECORD_NOT_FOUND"
      }
    ]
}

500 Unexpected Error

Unexpected error occured

Response Schema: application/vnd.api+json
required
Array of objects (ErrorUnexpectedError)

A list of errors that occurred.

Array
status
required
string

The HTTP status code for the error.

Example: "400"
detail
required
string

A message that explains the meaning of the error code. Developers are advised not to make programmatic use of this value, as it may change

Example: "The request failed because it was not in the correct format or did not contain valid data."
required
object

A list of links to resources that may be helpful in resolving the error.

required
object

Additional information about the error.

code
required
string

A code that indicates what went wrong.

Value Description
UNEXPECTED_ERROR

This one is on us. Something unexpected went wrong

Example: "UNEXPECTED_ERROR"
application/vnd.api+json
{
  • "errors": [
    • {
      • "status": "400",
      • "detail": "The request failed because it was not in the correct format or did not contain valid data.",
      • "links": {},
      • "meta": {
        • "request_id": "3c526bf4-f3c0-4c4a-a4cb-95f7db8b3bbe",
        • "trace_id": "4016616108459136584"
        },
      • "code": "UNEXPECTED_ERROR"
      }
    ]
}
➔ Next to Client Portal