{"uid":"cap_WbpHWq0Z6a0WsLfY3BMOF","slug":"providersignal-dso-affiliation-lookup-4e7054b5","name":"ProviderSignal DSO Affiliation Lookup","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/dso/affiliation","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","required":["npi"],"properties":{"npi":{"type":"string","pattern":"^\\d{10}$","description":"10-digit NPI"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","error","meta"],"properties":{"data":{"type":"object","properties":{"npi":{"type":"string"},"is_dso":{"type":"boolean"},"dso_label":{"type":["string","null"]},"siblings_sample":{"type":"array","items":{"type":"object","properties":{"npi":{"type":"string"},"state":{"type":["string","null"]},"last_name":{"type":["string","null"]},"first_name":{"type":["string","null"]}}}},"co_located_count":{"type":["integer","null"]},"dso_cluster_size":{"type":["integer","null"]},"inferred_practice_name":{"type":["string","null"]}},"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":"1376155820","is_dso":true,"dso_label":"Heartland Dental","siblings_sample":[{"npi":"1234567890","state":"AL","last_name":"DOE","first_name":"JOHN"}],"co_located_count":3,"dso_cluster_size":2847,"inferred_practice_name":"Smile Dental of Baytown"},"meta":{"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_gjFeR_sQSVvot_Ycf62ql","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":"Given a 10-digit NPI, returns whether the dental provider is affiliated with a Dental Service Organization (DSO), the DSO name, cluster size, co-located peers, and inferred practice name.","exampleAgentPrompt":"Can you check whether NPI 1376155820 is affiliated with a DSO, and if so, tell me the DSO name, how big their network is, and the inferred practice name?","exampleUseCases":[{"title":"Dental acquisition target screening","prompt":"I'm evaluating a dental practice for acquisition — can you check if NPI 1234567890 is already part of a DSO, which one, and how many locations are in that network?"},{"title":"Competitor DSO mapping for sales team","prompt":"Our reps are calling on dentists in Alabama — for NPI 1376155820, can you tell me if they're DSO-affiliated or independent, and show me a sample of co-located providers at that practice?"},{"title":"Provider directory enrichment pipeline","prompt":"I'm building a dental provider database and need to flag which providers are DSO-backed versus solo practices — can you look up NPI 9876543210 and return the DSO label and cluster size?"}],"resultDescription":"Returns a JSON object with: is_dso (boolean), dso_label (string or null), dso_cluster_size (integer or null indicating total network size), co_located_count (peers at the same address), inferred_practice_name, a siblings_sample array of co-located provider NPIs with state and name, plus a meta envelope with source attribution, data freshness timestamps, and billing details.","failureModes":["Invalid or non-existent NPI returns error object with code and message","NPI exists but belongs to a non-dental provider — DSO fields may be null","Payment failure (402) if x402 USDC payment or MPP token is invalid or insufficient","Rate limiting or auth failure if Bearer token is expired or missing","Data may lag by days if underlying NPI or state board sources haven't refreshed recently"],"whenToPreferThis":"Use this endpoint when you need a fast, single-provider DSO affiliation signal with source-cited provenance and a known per-call cost. It is purpose-built for dental market intelligence workflows — superior to generic NPI registries that lack DSO clustering, affiliation labels, or co-location data. Prefer it over manual board lookups when you need machine-readable DSO network size and sibling providers in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:40:02.824Z","isFirstParty":false}