{"uid":"cap_-EhCLJ1b8rBd3fE56DKiN","slug":"providersignal-territory-rollup-api-2b9d5f0c","name":"ProviderSignal Territory Rollup 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/territory/rollup","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":["state"],"properties":{"zip":{"type":"string","description":"Optional ZIP prefix"},"city":{"type":"string","description":"Optional partial city match"},"state":{"type":"string","description":"Required. Single 2-letter code or comma-list."},"county":{"type":"string","description":"Optional exact county match"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","error","meta"],"properties":{"data":{"type":"object","properties":{"filters":{"type":"object","properties":{"zip":{"type":["string","null"]},"city":{"type":["string","null"]},"state":{"type":"string"},"county":{"type":["string","null"]}}},"top_dsos":{"type":"array","items":{"type":"object","properties":{"dso_label":{"type":"string"},"practices":{"type":"integer"},"providers":{"type":"integer"},"states_covered":{"type":"integer"}}}},"by_signal":{"type":"object","properties":{"has_cms_claims":{"type":"integer"},"is_federally_excluded":{"type":"integer"},"retirement_risk_55plus":{"type":"integer"},"has_disciplinary_action":{"type":"integer"}}},"positioning":{"type":["object","null"],"properties":{"band":{"enum":["Premium","Average","Discount"],"type":"string"},"scope":{"type":"string"},"score":{"type":"number"},"modifier":{"type":"number"},"benchmark":{"type":"object","properties":{"tier":{"type":"string"},"collections_pct":{"type":["string","null"]},"ebitda_multiple":{"type":"string"}}},"confidence":{"type":"number"},"disclaimer":{"type":"string"}},"description":"State-level Market Multiple Positioning. Null for multi-state requests or unenriched states."},"by_affiliation":{"type":"object","properties":{"dso":{"type":"integer"},"independent":{"type":"integer"},"organizations":{"type":"integer"}}},"top_specialties":{"type":"array","items":{"type":"object","properties":{"providers":{"type":"integer"},"share_pct":{"type":"number"},"specialty":{"type":"string"}}}},"total_providers":{"type":"integer"},"by_license_status":{"type":"object","description":"Counts by normalized bucket: active, inactive, expired, retired, deceased, disciplined.","additionalProperties":{"type":"integer"}}},"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":{"filters":{"zip":null,"city":null,"state":"TX","county":null},"by_signal":{"has_cms_claims":180,"is_federally_excluded":8,"retirement_risk_55plus":3843,"has_disciplinary_action":878},"positioning":{"band":"Average","scope":"state","score":59,"modifier":1.03,"benchmark":{"tier":"solo","collections_pct":"65-85%","ebitda_multiple":"2.5-5x"},"confidence":100,"disclaimer":"Market-attractiveness positioning vs the public national benchmark. Not a transaction comp and not a practice-specific valuation."},"by_affiliation":{"dso":1036,"independent":13962,"organizations":8187},"total_providers":14998,"by_license_status":{"active":9325,"expired":3365,"retired":1147,"deceased":57,"inactive":2,"disciplined":62}},"meta":{"envelope_version":"1.0"},"error":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"2.5","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":"$2.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"2.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"2.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kFpgTp6R73qk-9EL4OdaQ","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"2.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns aggregated dental provider market intelligence for a US state or territory, including provider counts, DSO affiliations, acquisition signals, license status breakdowns, and market positioning benchmarks.","exampleAgentPrompt":"Pull me a territory rollup for Texas — I need total provider counts, DSO vs independent split, retirement risk signals, and the market positioning band for the state.","exampleUseCases":[{"title":"DSO expansion market sizing","prompt":"I'm evaluating whether to expand our DSO into Florida — can you give me the full territory rollup for FL including how many providers are there, what the top DSOs are, and the market positioning band?"},{"title":"Retirement risk pipeline identification","prompt":"We're looking for acquisition targets in California and want to focus on dentists near retirement age — pull me the territory rollup for CA and show me the retirement risk signal count and license status breakdown."},{"title":"Compliance and exclusion screening by state","prompt":"Before we finalize our credentialing sweep, can you give me a rollup for New York showing how many providers have disciplinary actions, federal exclusions, or expired licenses?"}],"resultDescription":"Returns a JSON object with: total provider count for the geography; by_affiliation breakdown (DSO vs independent vs organizations); top DSOs ranked by practice count and states covered; by_signal counts (CMS claims presence, federal exclusions, retirement risk 55+, disciplinary actions); by_license_status breakdown (active, expired, retired, deceased, inactive, disciplined); and a positioning object with market band (Premium/Average/Discount), score, modifier, confidence, and EBITDA multiple benchmark tier. Also includes applied filter echo and a citation meta envelope with source attribution.","failureModes":["Missing required 'state' parameter returns a 400 validation error","Invalid state code returns an error indicating no matching geography","Multi-state requests return null positioning object (only single-state supported for market positioning)","Unenriched states return null for the positioning object","Payment failure on x402 or MPP rail returns a 402 with payment instructions","Rate limits or invalid Bearer token returns 401/403"],"whenToPreferThis":"Use this endpoint when you need a high-level aggregate view of a dental market for an entire state, county, city, or ZIP cluster — particularly for M&A prospecting, DSO market sizing, territory planning, or compliance screening. Prefer this over the filtered provider list endpoint when you need statistical rollups and market signals rather than individual provider records. Best suited for strategic market analysis workflows where citation-backed, source-attributed data freshness is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:41:25.853Z","isFirstParty":false}