Provider intelligence, as a REST API.

Search and filter dental providers. Supports full-text search, specialty filters, geography, license status, DSO affiliation, Medicare billing history, practice size, and pagination (offset or cursor-based).

Returns { data, error, meta: { total, page, per_page, total_pages, next_cursor? } }

Retrieve a complete provider profile by NPI number. Includes co-located providers at the same address and any resolved practice-level entities.

Returns { data: { ...provider, co_located: [...], practice_entities: [...] }, error }

Map-rendering endpoint: returns geocoded provider points within a bounding box, with enough fields to render clusters and popups. Capped at 30,000 results per request.

Returns { data: [{ npi, last_name, first_name, specialty, latitude, longitude, license_status, license_expiration_date, has_disciplinary_action, is_federally_excluded, co_located_count, inferred_practice_name, graduation_year, date_of_birth, is_dso, dso_detection, dso_signals, is_sole_proprietor, organization_name, entity_type_code, ... }], error }

Bulk export provider data as CSV or JSON. Every filter parameter on /api/providers is also accepted here, including excluded, has_email, sedation_permit, retirement_risk, and include_suppressed. JSON format supports cursor-based pagination for iterating through large datasets.

CSV: file download. JSON: { data, error, meta: { total, count, per_page, next_cursor } }

Export practice scores as CSV or JSON. Includes 6-factor scoring algorithm results. Every filter parameter on /api/providers is also accepted here.

CSV: file download. JSON: { data: [{ ...provider, score, score_factors }], error, meta: { total, count } }. JSON has no next_cursor — pagination is offset-only here.

Practice scoring. Returns individual providers ranked by a six-factor algorithm: solo/independent status (25%), retirement risk (20%), practice vintage (15%), practice size (15%), license status (15%), and discipline history (10%). Each response row also includes a confidence score and (when applicable) Medicare Part B aggregates. Reps use the score to prioritize call lists; DSO biz-dev teams use the same score for acquisition target ranking.

Returns { data: [{ ...provider, score, score_factors, confidence, cms_medicare? }], error, meta }

Market whitespace analysis. Returns geographic areas scored by population-to-provider ratio, HPSA designation, and demographic factors. Supports state-wide or geo-scoped (ZIP+radius, city) queries.

Returns { data: [{ zip, provider_count, population, whitespace_score, ... }], error }

Medicaid fee schedule rates by CDT code and geography.

ZIP-level demographics from Census ACS data. Supports state-wide or geo-scoped queries. Returns 400 if `metric` is not one of the listed enum values.

Returns { data: [{ zip, ...demographic_fields }], error, metric }. The extra `metric` field echoes the requested sort metric so callers running parallel queries with different metrics can disambiguate responses without tracking request URLs.

Aggregate NPDB malpractice payment and adverse action trends by state and year. Anonymized, no individual provider data.

Market summary report: total providers, specialty breakdown, license status distribution, top organizations, DSO share, practice-size distribution, retirement-age count, HPSA designations. Supports state-wide and geo-scoped (city, ZIP+radius) queries.

HRSA Health Professional Shortage Area designations for dental care, deduplicated by county and enriched with county centroid coordinates for map overlays.

Returns { data: [{ hpsa_id, designation_type, hpsa_score, county_name, county_fips, latitude, longitude }], error }

Dental providers with CMS Medicare Part B billing history, geocoded for map overlay rendering. Returns lifetime billing aggregates per NPI (~3,000 providers nationally).

Returns { data: [{ npi, first_name, last_name, specialty, latitude, longitude, total_paid_lifetime, total_paid_latest_year, latest_year, years_active }], error }

Trigger feed summary for the dashboard home card. Returns a count-by-trigger-type breakdown for the requested state and lookback window. Excludes enumeration_backfill rows (heuristic snapshots). Use this for territory-level rollups; use /api/alerts/events for the underlying license-event detail.

Returns { data: { total, days, state, byType: { dso_acquisition, new_associate, new_specialist, new_practice, practice_opened_new_location, provider_moved, provider_departed, practice_moved, practice_closed, license_renewal_window }, types: [string] } }. Field name is camelCase byType, not snake_case.

License change events: expirations, status changes, new registrations, NPI deactivations, and disciplinary actions. Paginated.

Returns { data, error, meta: { total, page, per_page, total_pages } }

Dental-relevant federal grant opportunities from Grants.gov and SAM.gov. Paginated.

Medicaid/Medicare reimbursement rate change events detected by the quarterly diff pipeline. Surfaces CPT/CDT codes whose rates moved significantly.

NPDB malpractice trend anomaly events by state. Surfaces states whose latest-year adverse action count exceeds the 3-year rolling average by >20%.

Retrieve the authenticated user's profile (role, territory, company).

Update profile fields: role, display_name, company_name, territory_states, territory_zips, territory_metros.

List the authenticated user's saved searches.

Create a saved search. Body: { name, filters, notify_email }. Plan limits apply (Rep: 10, Team: unlimited).

Delete a saved search by ID. Ownership is verified.

List the authenticated user's bookmarked providers (Save + Set alert from the triage slideout). Each row carries enrichment fields (specialty, license status, practice context) joined client-side from the providers table.

Returns { data: [{ id, npi, notify_on_change, created_at, ...enrichment }], error }

Bookmark a provider. Idempotent on (user_id, npi); calling twice toggles or refreshes the row instead of duplicating. Body: { npi, notify_on_change?: boolean }.

Remove a saved provider. Pass ?npi=XYZ as a query parameter.

Read digest email frequency preference.

Update digest frequency. Body: { digest_frequency: 'off' | 'weekly' | 'daily' }.

Health check. Returns database connectivity status and latency. No authentication required.

Public statistics: provider counts, expiring licenses, DSO-flagged, solo practitioners, retirement-age providers, disciplinary actions, HPSA designations, active grants, enriched state counts. Cached 5 minutes. No authentication required.

Data source freshness status for all pipeline sources.