List waterfall runs
Recent runs of one waterfall: outcome, cost, time, attempts and fields filled.
Authorization
bearer In: header
Path Parameters
^wf_[a-z0-9]{8,40}$Query Parameters
1 <= value <= 10020Return runs created before this time
date-timeResponse Body
application/json
application/json
curl -X GET "https://example.com/v1/waterfalls/string/runs"{ "items": [ { "object": "waterfall_run", "id": "string", "waterfall_id": "string", "version": "string", "mode": "sync", "status": "queued", "outcome": "hit", "stop_reason": "first_hit", "fields_filled": [ "string" ], "cost_micro": 0, "latency_ms": 0, "batch_id": "string", "created_at": "2019-08-24T14:15:22Z", "completed_at": "2019-08-24T14:15:22Z", "attempts": 0 } ], "next_cursor": "string"}Run a waterfall POST
Run a waterfall on one input and get the golden record: data, _provenance per field (vendor, confidence, verified, conflicts), _attempts, outcome (hit, partial, miss, failed) and cost_micro. Sync by default (up to 50 s). wait: N seconds falls back to a queued run; async: true returns at once with status queued and the run id: poll waterfall_status with {id, run_id}. version defaults to published; use draft for an unpublished waterfall. Set max_cost_micro to cap spend. A vendor you have no key for is skipped; when none can run, the error is vendor_key_required naming them. For lists use waterfall_batch_run.
Get a waterfall run GET
Poll a run started with async or wait: status (queued, running, completed, failed, cancelled), then the golden record with _provenance per field, every attempt with its timing and error, and cost per filled field.