Independently approve a servicing action and enforce its financial/borrower-protection effects
/lending-servicing/actions/{id}/reviewsDedicated lending:servicing:approve, fresh human staff authentication and an actor different from the maker required. Replay binds actor and exact review; stale predecessors conflict. A transfer is restricted to funded, unsold, bank-owned loans before charge-off: current accrual, tied principal/ledger receivable, no pending money commands, 15-day advance notice and receiver acknowledgment of unchanged source package. Approval retains the package and changes collection/escrow servicing authority.
Path parameters
idstringRequiredHeaders
Idempotency-KeystringRequiredSend on every write that creates or changes money or state; a replay with the same key returns the original result with 200.
Body parameters
approvebooleanRequiredevidenceobjectRequiredEvidence identifies the actual reviewed input, never an inferred geocode or identity.
2 child attributes
referencestringRequiredsha256stringRequiredreasonstringRequiredReturns
200 OK
actionobjectRequired10 child attributes
appeal_untilstring · date or nullOptionalA business date, YYYY-MM-DD
effective_datestring · dateRequiredA business date, YYYY-MM-DD
endsstring · dateOptionalA business date, YYYY-MM-DD
evidenceobjectRequiredEvidence identifies the actual reviewed input, never an inferred geocode or identity.
2 child attributes
referencestringRequiredsha256stringRequiredkindstringRequiredContact, acknowledge, complete_application, forbearance, denial, withdrawal, foreclosure_referral, transfer_out
noticeobject or nullOptional3 child attributes
channelstringRequiredevidenceobjectRequiredEvidence identifies the actual reviewed input, never an inferred geocode or identity.
2 child attributes
referencestringRequiredsha256stringRequiredsent_atstring · date-timeRequiredprevious_idstringOptionalreasonstringRequiredrelated_action_idstringOptionaltransferobject or nullOptional6 child attributes
receiver_acknowledgment_evidenceobjectRequiredEvidence identifies the actual reviewed input, never an inferred geocode or identity.
2 child attributes
referencestringRequiredsha256stringRequiredreceiving_servicer_contactstringRequiredreceiving_servicer_idstringRequiredreceiving_servicer_namestringRequiredservicing_contract_evidenceobjectRequiredEvidence identifies the actual reviewed input, never an inferred geocode or identity.
2 child attributes
referencestringRequiredsha256stringRequiredsnapshot_sha256stringRequiredactorstringRequiredcase_idstringRequiredExample case_2tVh8nqLxq4GbDe0K1F6S9zRcWm
content_sha256stringRequiredcreated_atstring · date-timeRequireddecisionobject or nullOptional5 child attributes
actorstringRequiredapprovebooleanRequiredatstring · date-timeRequiredevidenceobjectRequiredEvidence identifies the actual reviewed input, never an inferred geocode or identity.
2 child attributes
referencestringRequiredsha256stringRequiredreasonstringRequiredidstringRequiredloan_idstringRequiredExample loan_2tVh8nqLxq4GbDe0K1F6S9zRcWm
Errors
Every error is a problem document with a stable code. See Errors.
400401403404409412413422424429500503