Watchlist API

API v1

Store the codes your team bills and measure how a new release changes their expected value.

Watchlist

Your team's watched code mix: up to 500 lines of code + optional pricing modifier, billing setting, and annual units. Aggregate reference data about a practice — codes and volumes only, nothing claim-shaped. PUT replaces the whole list (the payload is the complete desired state), so you can sync from your own system of record without diffing ours. Requires a team API token.

PUT /v1/watchlist

request

curl -X PUT https://localishealth.com/v1/watchlist \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"lines": [
    {"code": "99213", "annual_units": 4200},
    {"code": "99214", "setting": "facility", "annual_units": 800},
    {"code": "93000"}
  ]}'

response — 200

{
  "count": 3,
  "updated_at": "2026-08-05T18:00:00+00:00",
  "lines": [
    { "code": "93000", "modifier": "", "setting": "non_facility", "annual_units": null },
    { "code": "99213", "modifier": "", "setting": "non_facility", "annual_units": 4200 },
    { "code": "99214", "modifier": "", "setting": "facility", "annual_units": 800 }
  ]
}

Watchlist impact

What a release did to your watched mix, at national (GPCI-neutral) amounts with the standard conversion factor. Defaults to the latest release against the prior quarter; pass baseline=prior_revision to compare a release against its own superseded revision instead — the view that answers "what did CMS retroactively correct for a period we already billed", e.g. a mid-year conversion-factor patch (retroactive: true). Every watched line comes back: unchanged lines, and lines that can't be compared (carrier-priced, not in a release) with a reason — never silently dropped. Lines with annual_units are dollarized into annual_delta and summed.

GET /v1/watchlist/impact

request

curl "https://localishealth.com/v1/watchlist/impact?year=2026&quarter=B" \
  -H "Authorization: Bearer sk_live_…"

response — 200

{
  "release": { "year": 2026, "quarter": "B", "revision": 1 },
  "baseline": { "year": 2026, "quarter": "A", "revision": 2 },
  "retroactive": false,
  "changed": 1,
  "unchanged": 1,
  "not_comparable": 1,
  "annual_delta_total": -780.00,
  "lines": [
    { "code": "99213", "modifier": "", "setting": "non_facility", "annual_units": 4200,
      "comparable": true, "prior_amount": 95.19, "current_amount": 95.01,
      "delta_amount": -0.18, "delta_pct": -0.2, "annual_delta": -756.00, "reason": null }
  ]
}