Dry-run LCR quote preview
Rank the candidates this tenant could route the given destination through, ranked by the saved policy (or an OPTIONAL policy body override so an owner can preview a candidate policy BEFORE saving it). Returns per-candidate exposure (costs, default-route’s resolved price, rank and reason) and the winning row. Reporting only — compute-only, computation-only, comparison-only (no ledger, no routing side-effect).
Authorizations
Dashboard JWT token from Clerk
Headers
Stripe-style idempotency token. Pass a stable, client-generated value (1-255 chars) to dedupe retries on transient timeouts. The same key+credential+path replays the original response for 24h on 2xx (5min on 4xx, 30s on 5xx). Returns 409 if a concurrent request with the same key is already in flight; replayed responses include the Idempotency-Replay: true response header.
1 - 255Sandbox opt-in for Clerk-session-authenticated requests. Set to true to route the call through the test-mode pipeline: no real provider delivery, no credits deducted, response meta.test_mode: true. Ignored for live API keys (dv_live_sk_*) — server-to-server clients must use a test-prefixed key (dv_test_sk_*) to exercise sandbox. Test-prefixed keys unconditionally enable sandbox regardless of this header.
true, false Body
E.164 destination (e.g. +12125550123 — the form route-pick and pricing ladders already expect).
Optional segment quantity multiplier (per_segment pricing ladder multiplies by this).
Optional policy body — run the same editorial ranking on this override instead of the saved policy (preview BEFORE save).
Response
Candidate ranking — winner id/kind, policy in force, per-candidate rows with rank, reason and the resolved price exposure (or null cents when the pricing ladder soft-failed).
Candidate ranking — winner id/kind, policy in force, per-candidate rows with rank, reason and the resolved price exposure (or null cents when the pricing ladder soft-failed).