how_to_verify_income
How to verify someone’s income
Explains how to check or verify a person’s income (a tenant, applicant, borrower, guarantor, investor, or yourself), including bank-based income analysis, pay stubs, and their limits. Use when someone asks how to verify, check, or prove income.
Parametersaudience
start_income_verification
Start a bank-based income check
Returns the link and steps to request a bank-based income report from Income Checker for a tenant, applicant, borrower, or yourself. Use when the user wants to actually verify or check someone’s income, not just learn how.
Takes no parameters.
monthly_income_from_pay
Monthly income from pay
Converts a pay amount (hourly, weekly, every two weeks, twice a month, monthly, or annual) into gross monthly, annual, biweekly, weekly, and hourly income.
Parametersamountrequiredfrequencyrequiredhours_per_week
rent_to_income
Rent-to-income ratio
Income needed for a given rent (2.5x, 3x, 3.5x rules), the max rent for a given income at 3x, or the rent-to-income ratio when both are given. Pass monthly figures.
Parametersmonthly_rentmonthly_income
rent_affordability
How much rent can I afford
Affordable rent from gross monthly income using the 30% rule, the 3x-rent rule, a 25-30% comfortable range capped at 36% total debt, and 50/30/20.
Parametersmonthly_debtsmonthly_gross_incomerequired
debt_to_income
Debt-to-income ratio
Front-end (housing) and back-end debt-to-income ratios with common lender bands.
Parametersmonthly_housingrequiredother_monthly_debtsmonthly_gross_incomerequired
prorated_rent
Prorated rent
Rent owed for a partial first month, from the move-in date through the end of that month.
Parametersmethodmonthly_rentrequiredmove_in_daterequired
check_pay_stub_math
Check pay stub math
Checks the figures on a pay stub for internal inconsistencies: gross minus deductions vs net, hours × rate, Social Security and Medicare rates, pay period length, pay date, year-to-date totals, and suspiciously round numbers. Read the numbers off the stub and pass them in. Flags items for follow-up; it does not authenticate a document or prove fraud.
Parametershoursnet_payrequiredpay_dategross_payrequiredytd_grossdeductionsrequiredhourly_ratepay_frequencypay_period_endprior_ytd_grosspay_period_start
get_account
My Income Checker account
Shows the signed-in user’s email and how many verification credits they have left.
Takes no parameters.
buy_credits
Buy verification credits
Creates a secure Stripe checkout link for a pack of non-expiring verification credits. Packs: 1 for $5.00, 3 for $15.00, 5 for $25.00, 10 for $50.00, 25 for $125.00, 50 for $250.00. Give the user the link to pay; credits are added once payment completes.
Parametersquantityrequired
send_verification_request
Send an income verification request
Uses one credit to create a bank-based income check and emails the applicant a secure link to connect their bank through Plaid. Confirm the applicant’s name and email with the user before calling. The report is ready after the applicant connects; check it with list_verifications or get_report.
Parameterspurposeapplicant_namerequiredapplicant_emailrequiredrequested_by_name
list_verifications
List my verification requests
Lists the signed-in user’s income verification requests, newest first, with status and report links.
Parameterslimitstatus
get_report
Get an income report
Returns the income analysis for a completed verification: estimated monthly income, income sources, other deposits, and account balances. Present figures as estimates, never as verified or approved income.
Parametersverification_idrequired