{"uid":"cap_8lnBfw4MYKni29PI8Y9CL","slug":"providersignal-acquisition-scoring-api-c4ed0129","name":"ProviderSignal Acquisition Scoring API","description":"Healthcare market intelligence API. Unified provider directory + acquisition signals + license-events feed across all 50 US states, derived from NPI + state dental boards + CMS Medicare + OIG LEIE + state Medicaid + HRSA HPSA designations. All responses ship a citation envelope (`meta.envelope_version`, `meta.source_attribution`, `meta.request`) so agents can verify source freshness without out-of-band validation. Paid `/api/v1/agent/*` endpoints accept two per-call rails on a single 402: x402 (USDC on Base mainnet) and MPP (Stripe card via a Shared Payment Token), plus Bearer-token subscription auth for existing API keys. See [/docs/agent-payments](/docs/agent-payments) for the full flow. See [/docs/fields](/docs/fields) for the field glossary and [/llms.txt](/llms.txt) for the LLM crawler index.","url":"https://providersignal.com/api/v1/agent/scoring","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","properties":{"page":{"type":"integer","minimum":1},"state":{"type":"string"},"is_dso":{"enum":["true","false"],"type":"string"},"has_cms":{"enum":["true"],"type":"string"},"per_page":{"type":"integer","maximum":100,"minimum":1},"min_score":{"type":"integer","maximum":100,"minimum":0,"description":"Minimum acquisition-readiness score 0-100. Filters AFTER scoring."},"sole_prop":{"enum":["true","false"],"type":"string"},"specialty":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","error","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"npi":{"type":"string"},"score":{"type":"integer","maximum":100,"minimum":0},"last_name":{"type":["string","null"]},"confidence":{"type":"object","properties":{"score":{"type":"number"},"method":{"type":"string"}}},"first_name":{"type":["string","null"]},"score_factors":{"type":"object","description":"Per-component breakdown (solo_independent, practice_vintage, retirement_risk, practice_size, clean_record, license_freshness); components sum to the score.","additionalProperties":{"type":"number"}}},"additionalProperties":true}},"meta":{"type":"object","required":["envelope_version"],"properties":{"request":{"type":"object","properties":{"id":{"type":"string"},"endpoint":{"type":"string"},"billed_credits":{"type":"integer"},"billing_method":{"enum":["subscription","per_query","free","admin"],"type":"string"}}},"envelope_version":{"type":"string"},"source_attribution":{"type":"array","items":{"type":"object","properties":{"table":{"type":"string"},"license":{"type":"string"},"last_refresh":{"type":["string","null"]},"schema_version":{"type":"string"}}},"description":"Per-source citation: logical table, last successful refresh, schema version, license posture."}},"additionalProperties":true},"error":{"type":["object","null"],"description":"Null on success; { code, message } on failure."}}}}}}},"responseSchema":{"type":"json","example":{"data":[{"npi":"1699733048","score":87,"last_name":"AARON","confidence":{"score":92,"method":"completeness+multi_source"},"first_name":"EUGENE","score_factors":{"clean_record":10,"practice_size":12,"retirement_risk":18,"practice_vintage":14,"solo_independent":25,"license_freshness":8}}],"meta":{"total":542,"envelope_version":"1.0"},"error":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rqI16Y6JMQrmAG2klaXfe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns ranked dental/healthcare providers with acquisition-readiness scores (0-100) derived from NPI, license events, CMS, OIG, and Medicaid data","exampleAgentPrompt":"Pull me the top acquisition targets among independent dental practices in Texas — score them by retirement risk, practice vintage, and clean record, and show me only those scoring above 75.","exampleUseCases":[{"title":"DSO expansion target screening","prompt":"I'm building a list of acquisition targets for a dental support organization expanding in Florida — find me non-DSO sole proprietors with a ProviderSignal score above 80, filtered to general dentists."},{"title":"Retirement-risk pipeline identification","prompt":"Which independent dental providers in Ohio have the highest retirement risk scores right now? Show me the top 50, sorted by score, so I can prioritize outreach."},{"title":"CMS-enrolled practice vetting","prompt":"Find me CMS Medicare-enrolled dental providers in New York with acquisition scores above 70 and a clean OIG record — I want to see the score factor breakdown for each one."}],"resultDescription":"A paginated JSON array of scored providers, each with NPI, first/last name, overall acquisition-readiness score (0-100), per-component score factors (solo_independent, practice_vintage, retirement_risk, practice_size, clean_record, license_freshness), and a confidence object. The meta envelope includes total count, source attributions with last-refresh timestamps, envelope version, and billing metadata (credits used, billing method, request ID).","failureModes":["Invalid or missing query parameters return 400 with validation errors","Insufficient payment or expired API key returns 402 with x402/MPP payment challenge","State code not recognized returns empty result set or 400","min_score outside 0-100 range rejected by schema validation","per_page exceeding 100 returns schema validation error","Rate limiting or quota exhaustion returns 429","Stale source data indicated in meta.source_attribution last_refresh timestamps"],"whenToPreferThis":"Choose this endpoint when you need a pre-computed, multi-signal acquisition-readiness score across a large pool of providers rather than raw directory data. It is especially valuable when targeting dental or healthcare practice acquisition pipelines because it fuses NPI, license events, CMS, OIG LEIE, and Medicaid signals into a single ranked score with auditable source citations. Prefer it over raw directory lookups when you need to filter by retirement risk, practice vintage, or DSO status at scale. The citation envelope makes it suitable for compliance-sensitive M&A workflows where source provenance must be logged.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:42:11.844Z","isFirstParty":false}