LeedWallet · DSCR lead post

Field reference

The 35 fields LeedWallet posts to your endpoint for each lead: name, type, allowed values and format.

Fields35
MethodHTTP POST
Bodyapplication/json
ValuesJSON strings

1Overview

How a lead gets from LeedWallet into your system, in order.

Provide your endpointGive LeedWallet the URL that will receive leads and any authentication header it requires. This is configured at onboarding.
Accept the postEach lead arrives as one HTTP POST with a JSON body of 35 fields. Every value is a string. See section 2.
Map the fieldsMatch each field to your system using the tables in section 5. Convert numeric and yes/no values on your side.
Store the consent fieldsKeep tcpa_text, ip_address, user_agent, jornaya and trustedform_cert_url with the lead record. See section 5.5.
Confirm receiptReturn a 2xx HTTP status. Use transaction_id to reject duplicates.

2Delivery format

Transport and formatting rules that apply to every field in the post.

Transport: One HTTP POST per lead with a JSON body (Content-Type: application/json). Endpoint URL and any authentication headers are configured per buyer at onboarding.
Field presence: All 35 fields are present on every post. A field that does not apply to the lead is sent as an empty string, not null and not omitted.
Value types: Every value is sent as a JSON string, including numeric fields. Numbers contain no currency symbols or thousands separators. Yes/no fields contain the lowercase strings yes or no, not booleans.
Field names: Field names are case-sensitive. All are snake_case except createdAt.
Response: Return a 2xx HTTP status to confirm receipt.
Duplicate handling: transaction_id is unique per lead. Use it for duplicate checks.

3Field types

Type labels used in section 5, as defined by the LeedWallet delivery platform.

Type	Meaning
Text	Free-form string. Most are short; `user_agent` and `tcpa_text` can exceed several hundred characters.
Email	Email address, format-validated at submission.
Phone	10-digit US number.
State	Two-letter USPS abbreviation.
Postal code	Five-digit ZIP. Keep it as text so leading zeros survive.
IP address	IPv4 dotted quad, e.g. `203.0.113.42`. Store as text.
Numeric	Digits with an optional decimal point (`123`, `12.34`). No symbols or separators. Sent as a string.
List	One of the allowed values, spelled and cased as shown.

4Conditional fields

5 fields

Five fields carry a value only when another field has a specific value. Otherwise they arrive as an empty string. Fields not listed here are not tied to another field's value.

When	These fields are populated	Otherwise
`purchase_refinance` is `purchase_buy`	purchase_price has_psa	Empty on `refinance_rate_term` and `refinance_cash_out`.
`has_hoa` is `yes`	monthly_hoa	Empty when `has_hoa` is `no`.
`existing_mortgage` is `one` or `two`	remaining_mortgage_primary	Empty when `existing_mortgage` is `none`.
`existing_mortgage` is `two`	remaining_mortgage_secondary	Empty when `existing_mortgage` is `none` or `one`.

5Fields

28 underwriting · 7 consent & delivery

Five groups. Field names are exactly as posted. List fields contain one of the values shown; all other types show an example value. Fields whose value depends on another field are listed in section 4.

5.1Borrower contact

8 fields

Borrower name and contact details.

Field	Type & format	Description
`first_name`	Text ExampleJordan	Borrower's first name.
`last_name`	Text ExampleAlvarez	Borrower's last name.
`email`	Email Examplejordan.alvarez@example.com	Borrower's email address. Format-validated at submission.
`mobile`	Phone Example(561) 555-0142	Borrower's mobile number, 10-digit US. Remove formatting if your system stores digits only.
`address`	Text Example1420 NW 8th Ave	Street address as entered on the form.
`city`	Text ExampleFort Lauderdale	City as entered on the form.
`state`	State ExampleFL	Two-letter USPS abbreviation (CA, NY, FL).
`zip_code`	Postal code Example33311	Five-digit ZIP. Store as text to preserve leading zeros.

5.2Loan request

7 fields

Transaction type, amounts, credit band and timing.

Field	Type & format	Description
`purchase_refinance`	List Allowed values purchase_buy refinance_rate_term refinance_cash_out	Transaction type. Determines which purchase- and refinance-specific fields carry a value.
`loan_amount`	Numeric Example288750	Requested loan amount in USD. Digits only, no currency symbol or commas.
`purchase_price`	Numeric Example385000	Contract price on a purchase. Empty on refinances.
`as_is_value`	Numeric Example390000	Borrower's estimate of the property's current as-is value.
`has_psa`	List Allowed values yes no	Whether a purchase and sale agreement is already signed. Purchases only.
`expected_closing_date`	Text Example10/15/2026	Target closing date as entered by the borrower. Free text, not a normalized date.
`credit_score`	List Allowed values Excellent (800-850) Very Good (740-799) Good (670-739) Fair (580-669) Poor (300-579)	Credit band as reported by the borrower. Delivered leads are Good (670+) or better; Fair and Poor are listed for schema completeness.

5.3Subject property & cash flow

8 fields

Property details and the income and expense inputs for the DSCR calculation.

Field	Type & format	Description
`property_use`	List Allowed values Investment Property Owner Occupied	How the borrower will use the property.
`property_type`	List Allowed values Single Family Residence Multi Family (2-4) Multi Family (5+) Condo Townhouse Manufactured Modular Commercial Property	Property type as selected on the form.
`short_term_rental`	List Allowed values yes no	Whether the property will be operated as a short-term rental.
`monthly_rent`	Numeric Example3100	Current or projected gross monthly rent. Income input for the DSCR calculation.
`annual_tax`	Numeric Example5200	Annual property taxes in USD.
`annual_insurance`	Numeric Example2400	Annual hazard insurance premium in USD.
`has_hoa`	List Allowed values yes no	Whether the property carries HOA dues.
`monthly_hoa`	Numeric Example250	Monthly HOA dues in USD. Empty when has_hoa is no.

5.4Existing financing & experience

5 fields

Existing liens on the property and borrower experience.

Field	Type & format	Description
`first_time_investor`	List Allowed values yes no	Whether this is the borrower's first investment property.
`existing_mortgage`	List Allowed values none one two	Number of mortgages currently on the property.
`remaining_mortgage_primary`	Numeric Example212000	Balance on the first mortgage in USD. Empty when existing_mortgage is none.
`remaining_mortgage_secondary`	Numeric Example45000	Balance on the second mortgage in USD. Empty unless existing_mortgage is two.
`owned_property_more_than_6_months`	List Allowed values yes no	Whether the borrower has held title for more than six months (seasoning).

5.5Consent, compliance & delivery

7 fields

Consent records and identifiers for the lead.

Field	Type & format	Description
`tcpa_text`	Text ExampleBy clicking Submit, I agree to receive calls and text messages from LeedWallet and up to three lending partners at the number provided, including via automated dialing technology. Consent is not a condition of purchase.	The exact consent language the borrower agreed to at submission. Store with the lead record.
`ip_address`	IP address Example203.0.113.42	Borrower's IP address at submission.
`user_agent`	Text ExampleMozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1	Browser user-agent string captured at submission.
`jornaya`	Text Example3f2a9c1e-7b4d-4e8a-9f01-2c6d5b8a1e47	Jornaya LeadiD token for independent consent verification.
`trustedform_cert_url`	Text Examplehttps://cert.trustedform.com/6f1c0a9e2b7d4c3a8e5f1b2d9c0a7e6f4d3b2a10	TrustedForm certificate URL. Retain it in your TrustedForm account promptly; unclaimed certificates expire.
`createdAt`	Text Example2026-09-04 14:32:07	Submission timestamp, delivered as a string. Note the camelCase name; all other fields are snake_case.
`transaction_id`	Text Example8c41f2e7-9a3b-4d6e-b5c0-72f1a9e3d4b8	LeedWallet's unique ID for the lead. Use it for duplicate checks and when referencing the lead with LeedWallet.

No field matches that search.

6Sample post

Fields in the order sent

Example values only: a purchase with no existing mortgage and no HOA, so the conditional fields that do not apply are empty.

{  "first_name": "Jordan",  "last_name": "Alvarez",  "email": "jordan.alvarez@example.com",  "address": "1420 NW 8th Ave",  "city": "Fort Lauderdale",  "state": "FL",  "zip_code": "33311",  "ip_address": "203.0.113.42",  "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Mobile/15E148 Safari/604.1",  "tcpa_text": "By clicking Submit, I agree to receive calls and text messages from LeedWallet and up to three lending partners at the number provided, including via automated dialing technology. Consent is not a condition of purchase.",  "purchase_refinance": "purchase_buy",  "credit_score": "Very Good (740-799)",  "property_use": "Investment Property",  "property_type": "Single Family Residence",  "has_psa": "yes",  "expected_closing_date": "10/15/2026",  "purchase_price": "385000",  "as_is_value": "390000",  "loan_amount": "288750",  "short_term_rental": "no",  "first_time_investor": "no",  "existing_mortgage": "none",  "remaining_mortgage_primary": "",  "remaining_mortgage_secondary": "",  "owned_property_more_than_6_months": "no",  "annual_tax": "5200",  "annual_insurance": "2400",  "monthly_rent": "3100",  "has_hoa": "no",  "monthly_hoa": "",  "mobile": "(561) 555-0142",  "createdAt": "2026-09-04 14:32:07",  "jornaya": "3f2a9c1e-7b4d-4e8a-9f01-2c6d5b8a1e47",  "transaction_id": "8c41f2e7-9a3b-4d6e-b5c0-72f1a9e3d4b8",  "trustedform_cert_url": "https://cert.trustedform.com/6f1c0a9e2b7d4c3a8e5f1b2d9c0a7e6f4d3b2a10"}

The borrower, property, tokens and consent text above are placeholders and do not describe a real lead.