escrow
mortgage-servicing
statement-audit
mcp:audit_borrower_escrow_stmt

Borrower Escrow Statement Auditor

Audits a servicer escrow accounting statement from borrower-supplied values only: recomputes the aggregate accounting trial running balance month by month, compares the servicer stated end-of-month balances line by line, flags each discrepant line, checks the stated cushion against the one-sixth-of-annual-disbursements cap, and classifies the recomputed account as balanced, shortage, surplus, or deficiency. Identifier-like fields are refused, never echoed; over 12 monthly periods is refused.

Tool URL: https://ainumbers.co/chaingraph/732-borrower-escrow-auditor.html AP2/Policy Mandate export: yes

post/v1/tools/audit_borrower_escrow_stmt

Request

  • Base URL: https://ainumbers.co
  • URL: https://ainumbers.co/v1/tools/audit_borrower_escrow_stmt
  • Auth: none declared

Request body

starting_balancenumber required

Stated opening escrow balance at the start of the computation year, in dollars. Required.

monthly_paymentsnumber[] required

Stated monthly escrow deposit values, one per month, at most 12 entries. Values only - never dates or identifiers.

disbursementsnumber[] required

Stated monthly escrow disbursement values, one per month, at most 12 entries. Values only.

stated_balancesnumber[] required

The servicer statement end-of-month balance values, one per month. Compared line by line against the recomputation.

stated_cushionnumber

Optional: the servicer stated/target cushion amount. Checked against the one-sixth cap when supplied.

borrower_currentboolean

Optional: whether the borrower is current at analysis time. A refund-band surplus without it holds the audit for manual review.

monthly_escrow_paymentnumber

Optional: the borrower's monthly escrow payment in dollars, the base for the one-month shortage threshold. Defaults to the mean of monthly_payments.

servicer_chosen_course'do_nothing' | 'repay_within_30_days' | 'repay_equal_monthly_12_plus_months'

Optional: the course the servicer chose: do_nothing, repay_within_30_days or repay_equal_monthly_12_plus_months. Reported as permitted or not.

Response

Successful tool execution result

verdictstring
account_statusstring nullable
periods_analyzedinteger
recomputed_balancesnumber[]
recomputed_low_pointnumber
target_low_pointnumber
total_annual_disbursementsnumber
cushion_cap_amountnumber
stated_cushionnumber nullable
cushion_within_capboolean nullable
shortage_amountnumber
surplus_amountnumber
shortage_threshold_basenumber
shortage_threshold_base_sourcestring
shortage_at_or_above_one_month_paymentboolean nullable
shortage_permitted_coursesstring[]
servicer_course_permittedboolean nullable
surplus_refund_requiredboolean
surplus_refund_unverifiedboolean
discrepanciesobject
evidenceobject
manual_review_requiredboolean

Changes

No recorded changes to this operation across all 1 revision of this API.