PierPierdocs

Errors

Pier uses HTTP codes to indicate the status of an API request. Generally, 2xx indicates success, 4xx indicates something was wrong with the information provided, and 5xx indicates something went wrong on Pier's servers.

Attributes

  • error_type string: The type of error, which can be one of APPLICATION_ERROR, BORROWER_ERROR, LOAN_AGREEMENT_ERROR, INVALID_REQUEST_ERROR, or API_ERROR.
  • error_code string: The specific error that occurred, which can be used programmatically.
  • error_message string: A human-readable error message for developers. These can change and should generally not be used programmatically.
  • error_detail list of objects: In some cases, like a validation error, we'll return a list of objects with more information about the parameter that is invalid.
{
    "error_type": "BORROWER_ERROR",
    "error_code": "INVALID_INPUT",
    "error_message": "A value provided in the body is incorrect. See error_detail for more",
    "error_detail": [
      {
        "value": "12708921",
        "msg": "EIN must be 9 digits",
        "param": "ein",
        "location": "body"
      }
    ]
}

Error Codes

error_codeerror_typestatuserror_message
INTERNAL_SERVER_ERRORAPI_ERROR500An unexpected error occurred
PRODUCT_NOT_SUPPORTEDAPI_ERROR403This product is not supported for your api keys
NON_ZERO_INTEREST_NOT_ENABLEDAPI_ERROR403Your account is not permitted to create loans with interest
ENDPOINT_NOT_ALLOWED_IN_PRODUCTIONAPI_ERROR403This endpoint is only allowed in the sandbox
DUPLICATE_EINBORROWER_ERROR400A borrower with that EIN already exists
DUPLICATE_SSNBORROWER_ERROR400A borrower with that SSN already exists
UNABLE_TO_DELETE_BORROWERBORROWER_ERROR400There was an error attempting to delete the borrower
UNSUPPORTED_STATEBORROWER_ERROR400This state is not supported for your API keys
APPLICATION_NOT_FOUNDAPPLICATION_ERROR404The application resource does not exist
APPLICATION_CANNOT_BE_CREATEDAPPLICATION_ERROR400The application credit type can't be created for this type of borrower
APPLICATION_CANNOT_BE_APPROVEDAPPLICATION_ERROR400The application's status must be pending in order to approve it
APPLICATION_CANNOT_BE_REJECTEDAPPLICATION_ERROR400The application's status must be pending in order to reject it
APPLICATION_CANNOT_BE_EVALUATEDAPPLICATION_ERROR400The application's status must be pending in order to evaluate it
BORROWER_NOT_FOUNDBORROWER_ERROR404The borrower resource does not exist
CUSTOMER_ALREADY_EXISTSCUSTOMER_ERROR400A customer with this email already exists
CUSTOMER_NOT_FOUNDCUSTOMER_ERROR404The customer resource does not exist with this client id
INVALID_BORROWER_IDBORROWER_ERROR400The borrower_id specified is invalid
INVALID_APPLICATION_IDAPPLICATION_ERROR400The application_id specified is invalid
LOAN_AGREEMENT_NOT_FOUNDLOAN_AGREEMENT_ERROR404The loan agreement resource does not exist
LOAN_AGREEMENT_ALREADY_EXISTSLOAN_AGREEMENT_ERROR400A pending loan agreement for this application already exists
LOAN_AGREEMENT_CANNOT_BE_CREATEDLOAN_AGREEMENT_ERROR400Can only create loan agreements for approved applications
LOAN_AGREEMENT_CANNOT_BE_SIGNEDLOAN_AGREEMENT_ERROR400The loan agreement's status must be pending_signature in order to sign it
LOAN_AGREEMENT_CREATION_FAILEDLOAN_AGREEMENT_ERROR400The loan agreement could not be created. Please retry
STATE_NOT_SUPPORTEDAPPLICATION_ERROR400The applicant's state or territory is not supported
UNSUPPORTED_OFFER_TERMSAPPLICATION_ERROR400The requested offer terms are not supported for this state
UNAUTHORIZEDINVALID_REQUEST_ERROR401The API key is invalid
FACILITY_ALREADY_EXISTSFACILITY_ERROR400A facility already exists for this loan agreement
FACILITY_CANNOT_BE_CREATEDFACILITY_ERROR400The loan agreement must have a status of signed in order to create a facility
FACILITY_NOT_FOUNDFACILITY_ERROR404The facility resource does not exist
FACILITY_CANNOT_BE_CLOSEDFACILITY_ERROR400The facility is already closed
MISSING_REPAYMENT_BANK_DETAILSPAYMENT_ERROR400Invalid or missing repayment bank account & routing info
PAYMENT_NOT_FOUNDPAYMENT_ERROR404The payment resource does not exist
UNABLE_TO_INITIATE_PAYMENTPAYMENT_ERROR400Unable to initiate payment
PAYMENT_ALREADY_SUBMITTEDPAYMENT_ERROR400Payment with this id has already been submitted
OFFER_NOT_FOUNDLOAN_AGREEMENT_ERROR404The accepted offer id is invalid or does not exist
INVALID_WEBHOOK_URLINVALID_REQUEST_ERROR400The webhook url is not a valid url
KYC_NOT_APPROVEDBORROWER_ERROR400The borrower's KYC status must be approved
BALANCE_REMAINING_LESS_THAN_PAYMENTPAYMENT_ERROR400The remaining balance is less than the payment submitted
DISBURSEMENT_ACH_DISABLEDFACILITY_ERROR400Your account is not enabled for ACH disbursements
DISBURSEMENT_AMOUNT_EXCEEDS_FACILITY_AMOUNTFACILITY_ERROR400The disbursement amount may not exceed the loan amount
DISBURSEMENT_NOT_FOUNDFACILITY_ERROR404The disbursement resource does not exist
LEDGERING_DISABLEDLEDGERING_ERROR400Your account is not enabled for ledgering