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, Medicaid state-roster enrollment (medicaid=true), 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, has_fax, 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, with the score breakdown and, on request, the score_version, transition_likelihood and transition_probability columns. Every filter parameter on /api/providers is also accepted here.

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

One state's detected Medicaid dental fee-schedule changes as CSV: every schedule and every change, largest move first. The same filters as /api/alerts/rates narrow it (locality, type, q, sort, min_pct, significant_only, which defaults to false here) and the file is then named -view. Columns: State, Schedule, Schedule (as published), CDT code, Procedure (ProviderSignal's own label), Family, Change, Old rate, New rate, Change %, Effective quarter, Detected.

CSV: file download named medicaid-dental-rate-changes-<state>-<quarter>.csv.

Practice scoring. Returns individual providers ranked by the acquisition score. Since 2026-10-19 the score is the dentist's transition likelihood (a weekly model's percentile, within the state, of how likely the dentist is to leave practice; in a backtest over March to October 2026 its top tenth left practice at about 4 times the base rate) times an acquisition fit (ownership, independence, size, record, license health). 70 or more is roughly the top 5% of a state's dentists. The score and score_factors field names did not change; their meaning did, and score_version says which formula a row carries: 3 where the likelihood applies, 2 for hygienists and assistants on the older six-factor formula. Rows also carry transition_likelihood and transition_probability. API-key calls default to dentists when provider_type is absent (send provider_type=all for every individual); the dashboard sends its own. 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, score_version, transition_likelihood, transition_probability, 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. Includes all trigger sources by default (opt-out via include_backfill=0). 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.

Detected changes to a state's published Medicaid dental fee schedules: rate increases and decreases, codes added and codes removed, from the snapshot diff of each published schedule since June 2026. One schedule at a time (the state's default unless locality says otherwise), largest move first. The response meta carries the resolved schedule and the state's change summary (codes moved, the median move, the largest moves, codes added and removed, the schedules that carry events, the last detection date).

Returns { data: [{ id, cpt_cdt_code, code_description, state, locality, event_type, old_rate, new_rate, rate_change_pct, is_significant, effective_quarter, created_at }], error, meta: { total, page, per_page, total_pages, locality, summary } }

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.