API Documentation

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, ... }], error }

Bulk export provider data as CSV or JSON. Supports all provider search filters. 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 acquisition target scores as CSV or JSON. Includes 6-factor scoring algorithm results. Supports all scoring filters.

CSV: file download. JSON: { data: [{ ...provider, score }], error, meta: { total, count } }

Acquisition target scoring. Returns individual providers ranked by a six-factor algorithm: solo status (25%), retirement risk (20%), practice vintage (15%), practice size (15%), license health (15%), and clean record (10%). Each response row also includes a confidence score and (when applicable) Medicare Part B aggregates.

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.

Medicaid fee schedule rates by CDT code and geography.

ZIP-level demographics from Census ACS data. Supports state-wide or geo-scoped queries.

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 }

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 (Pro: 10, Growth: unlimited).

Delete a saved search by ID. Ownership is verified.

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.