{"uid":"cap_7vTSAHJLvuidgtGgJaCSe","slug":"providersignal-healthcare-provider-search-01f43c2a","name":"ProviderSignal Healthcare Provider Search","description":"Filtered provider list with pagination. Filter on state, county, ZIP, specialty, DSO/Independent, license status, Medicaid state-roster enrollment.","url":"https://providersignal.com/api/v1/agent/search","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"zip":{"type":"string"},"city":{"type":"string"},"page":{"type":"integer"},"state":{"type":"string","description":"Single 2-letter code or comma-list (e.g. 'TX,FL,CA')"},"is_dso":{"type":"string"},"has_cms":{"type":"string"},"medicaid":{"type":"string","description":"true = state-listed on a Medicaid enrolled-provider roster (NY + CA rosters currently; state-listed enrollment, not verified acceptance)"},"per_page":{"type":"integer"},"specialty":{"type":"string","description":"Exact NUCC taxonomy specialty match"},"license_status":{"type":"string","description":"Single value or comma-list of normalized buckets (active/inactive/expired/retired/deceased/disciplined/pending)"}}},"responseSchema":{"type":"object","required":["data","error","meta"],"properties":{"data":{"type":"array","items":{"type":"object","properties":{"npi":{"type":"string"},"city":{"type":["string","null"]},"state":{"type":["string","null"]},"last_name":{"type":["string","null"]},"specialty":{"type":["string","null"]},"first_name":{"type":["string","null"]},"medicaid_participating":{"type":["boolean","null"],"description":"State-listed on a Medicaid enrolled-provider roster (NY/CA so far); null = no ingested roster lists this NPI."}},"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."}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.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":"$0.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2znfyoYRxlYfEddkuQgZ_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search and filter a database of healthcare providers by state, county, ZIP, specialty, DSO/independent status, license status, and Medicaid roster enrollment with pagination.","exampleAgentPrompt":"Find me a list of active, independently-owned dental providers in Texas and Florida who are enrolled on the Medicaid roster — show me 25 results per page, starting with page 1, and filter by the specialty 'Dentist' using the NUCC taxonomy.","exampleUseCases":[{"title":"Medicaid network adequacy audit","prompt":"Pull me a list of providers in New York who are state-listed on the Medicaid enrolled-provider roster and have an active license — filter by specialty 'General Practice' and give me 50 per page starting at page 1."},{"title":"DSO market intelligence research","prompt":"I need to find all DSO-affiliated dental providers in California and Texas with active licenses — search by state 'CA,TX', set is_dso to true, and give me 25 results per page."},{"title":"License compliance monitoring","prompt":"Search for any healthcare providers in Florida whose license status is expired or disciplined — return 20 results per page on page 1 so I can flag them for our credentialing review."}],"resultDescription":"Returns a paginated array of provider records, each containing NPI, first and last name, city, state, specialty, and a Medicaid participation flag (true/false/null). Also includes metadata with request ID, billing method, billed credits, envelope version, and per-source data attribution including table name, license, last refresh date, and schema version. Errors are returned as a structured object with code and message.","failureModes":["Invalid or unsupported state code returns empty results or validation error","Unrecognized NUCC taxonomy specialty string returns no matches","Medicaid filter only covers NY and CA rosters — other states return null participation flags","Exceeding pagination limits or passing invalid page/per_page integers may cause errors","No matching providers for given filter combination returns empty data array","Payment failure (x402) blocks the request before data is returned"],"whenToPreferThis":"Use this endpoint when you need to search or filter U.S. healthcare providers by geographic area, specialty, license status, DSO affiliation, or Medicaid roster enrollment. It is especially valuable for credentialing workflows, network adequacy checks, Medicaid compliance research, and dental/healthcare market intelligence. Prefer this over general NPI lookup tools when multi-field filtering (e.g. state + specialty + Medicaid + license status) and pagination are required in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:35:14.283Z","isFirstParty":false}