Underwrite a list of properties
Send a list of addresses to get one result per property in submission order.
Batch answers carry the core numbers only, with no comps list.
Use Score a property by address or property identifier to get those sales.
Send the list
Each item in properties accepts the single-call inputs.
The envelope accepts only that array; options belong inside each item.
Duplicate addresses are allowed, and each is charged.
Save your API key, the credential identifying you, in INVESTORLIFT_API_KEY.
Your account is the record owning your keys and the money you add.
Use a client timeout of at least 30 seconds.
The second address is a placeholder; the captured answer shows its real failure.
Read each result
Show the full response (100 lines)
Full response
results preserves submission order, with none omitted or reordered.
Each position answers the input at that position.
Only error entries carry results[].status and results[].type; branch on the type to choose a fix.
An underwritten entry uses the single-call member names and meanings, including max_allowable_offer.
When max_allowable_offer.clamped is true, no price clears the target margin: do not show the amount as an offer.
Conditional members can still be absent.
Read Maximum allowable offer before using the ceiling in your workflow.
effective_sample_size measures evidence supporting the model, and is absent when that estimate is withheld.
as_is_similar_band.qualifying_sales counts sales passing its filter, including when the range falls back to all comparable sales.
These are different counts.
Keep subject_property.property_id for property history; use an address when underwriting again.
Read the call's Trace ID, its call identifier, from the trace-id response header when contacting support.
Every entry shares the call's identifier; the captured error also includes results[].trace_id.
Understand charges and refunds
Each submitted property is charged the batch call's price from your balance; see Per-call prices. A covered property failure returns that property's charge to your balance as a refund.
The whole batch is charged before any property is underwritten. If your balance, the money available on your account, cannot cover it, the entire batch is rejected without charging or splitting it. After adding funds, you can retry unchanged; batches are never partially accepted.
The reference publishes the batch limit as maxItems.
Exceeding it returns 413 before charging, with limit and submitted counts.
Covered failures use the single call's error body and refund reasons.
A covered failure leaves an error entry, refunds its share and still attempts later properties.
The response remains 200.
Covered reasons are an ambiguous address, an address outside coverage, an unscorable address, a service failure or a service timeout; see errors.
An uncovered refusal stops processing: later properties are not attempted, no results array returns, and the request answers 503 spend-indeterminate.
Every recorded charge is returned to your balance, including already underwritten properties whose answers are not returned.
The request is retryable; you pay only for properties that produced an answer.
Retry safely
Send Idempotency-Key and follow Retry safely.
Using one key for the same body on the single and batch endpoints is a conflict, never a replay.