latestOpenAPI 3.1.02026-08-21382548.5 KB

c80d2b343f16

discovery-v2

Direct Screen To Pipeline

Screen one prepared parcel against a saved buy box, whether or not it is eligible.

POST /v2/pipeline answers "add this ranked lead" and correctly refuses a parcel that fails a must-have. This route answers the other half of the product requirement — "screen this specific site" — and refuses nothing that exists in the market: a failing parcel is saved with verdict HOLD and its real failed evidence, so the customer gets an answer instead of a dead end.

Everything else is identical to a discovery promotion, deliberately: same entitlement and vintage checks, same canonical spec identity, same single transaction, same idempotency, and the same hard boundary — no provider call, no contact, no cost-ledger row. The saved row never enters discovery results; discovery reads parcel facts, not promoted matches.

post/v2/pipeline/direct

Headers

authorizationstring nullable
X-Tenantstring nullable

Request body

parcel_keystring required
buy_boxstring required
vintage_idstring uuid nullable

Response

Successful Response

property_idstring uuid required
pipeline_item_idstring uuid required
buy_box_match_idstring uuid required
diligence_job_idstring uuid required
statusstring required