← Guides

Member navigation and care-team tools

Try it on a test key

curl -s "https://api.wellwardhealth.com/v1/prices?service=lipid-panel&near=00010&sort=price" -H "Authorization: Bearer $WELLWARD_KEY"

For a navigator, a member app or a care-team console: show a member their options for one service, near them, with the price first.

  1. What do they need? Turn their words into a service with /search, or pick from /services. If the service has several core forms (variants), ask which one.
  2. Do we have it there? /coverage?near=<zip>&service=<slug> is free. none → go to step 5.
  3. Show the options. /prices?service=…&near=…&sort=price. Show each practice's price, name and distance_miles; lead with summary ("12 practices, $180–$420, typical $260") so the member sees the range before the list.
  4. Show the disclaimer beside the prices — "A quote is not a binding offer. Confirm price with the provider before care." (Displaying prices).
  5. Nothing nearby? Offer to find out: request the price and tell the member when to expect it (expected_by).

One annotated record from step 3 (abridged; a test-key response):

{
  "id": "fx_jb_lp09",                 // stable price id — use it to refresh or report
  "amount": { "cents": 4900, "currency": "USD", "display": "$49" },
  "variant": { "key": "standard-test", "name": "Standard test" },
  "practice": {
    "name": "[TEST] Sandpiper Clinical Lab",
    "phone": "+15415550141",          // what the member can call to confirm
    "geo": { "precision": "rooftop" } // (lat, lng abridged) "zip" = approximate distance
  },
  "distance_miles": 4.3,
  "as_of": "2026-08-24",              // the day it was quoted (test dates shift monthly) — optional to show
  "conditions": { "note": "Fasting draw. Includes the blood draw fee." },
  "disclaimer": "A quote is not a binding offer. Confirm price with the provider before care."
}

Page only as far as you show: each page of 20 is a Read, and summary already tells the member the range.

API reference · Dashboard · Questions: hello@wellwardhealth.com