{"uid":"cap_8s_ST1Q3LtMvlK5cEd1AP","slug":"providersignal-license-events-historical-7de204ec","name":"ProviderSignal License Events Historical","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/license/events/historical","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}$"},"limit":{"type":"integer","default":100,"maximum":500,"minimum":1},"event_type":{"type":"string","description":"Optional filter — e.g. 'STATUS_CHANGE', 'DISCIPLINARY_ACTION', 'ADDRESS_CHANGE'"}}}},"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"},"events":{"type":"array","items":{"type":"object","properties":{"state":{"type":["string","null"]},"source":{"type":"string"},"new_value":{"type":["string","null"]},"old_value":{"type":["string","null"]},"created_at":{"type":"string"},"event_date":{"type":["string","null"]},"event_type":{"type":"string"}},"additionalProperties":true}},"total_events":{"type":"integer"}}},"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","events":[{"state":"TX","source":"tsbde","new_value":"Expired","old_value":"Active","created_at":"2025-11-01T03:14:22Z","event_date":"2025-10-31","event_type":"STATUS_CHANGE"}],"total_events":4},"meta":{"envelope_version":"1.0"},"error":null}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1.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":"$1.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_sdWVBmkeIHdve6Dq_jMyg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves the full historical log of license status changes, disciplinary actions, and address changes for a specific US healthcare provider by NPI number.","exampleAgentPrompt":"Pull the full license event history for the dentist with NPI 1376155820 — I want to see any status changes or disciplinary actions across all states.","exampleUseCases":[{"title":"Pre-acquisition provider due diligence","prompt":"Before we finalize the acquisition of this dental practice, pull the complete license history for NPI 1376155820 and flag any disciplinary actions or license revocations."},{"title":"Compliance monitoring for credentialing","prompt":"I need to verify whether the provider with NPI 1003845678 has had any license status changes or disciplinary actions in Texas in the last few years — pull their full event history."},{"title":"Investigative alert on expired license","prompt":"We got a flag that a provider's license may have lapsed — can you check the license event history for NPI 1922337456 and tell me if there's a STATUS_CHANGE from Active to Expired?"}],"resultDescription":"Returns a paginated array of license events for the specified provider, each with event type (e.g. STATUS_CHANGE, DISCIPLINARY_ACTION, ADDRESS_CHANGE), state, source system, old and new values, event date, and creation timestamp. Also includes total event count and a citation envelope with source attribution, last refresh timestamps, and schema versions for each underlying data source.","failureModes":["Invalid NPI format (must be exactly 10 digits) returns a validation error","Unknown NPI with no records returns an empty events array with total_events: 0","Payment failure via x402 or MPP returns HTTP 402 with payment requirements","Rate limiting or quota exhaustion returns HTTP 429","Source data temporarily unavailable may result in stale or partial citation envelope"],"whenToPreferThis":"Use this endpoint when you need the complete auditable timeline of license changes for a specific provider identified by NPI — particularly for due diligence, credentialing, compliance auditing, or acquisition workflows. It is preferable to point-in-time license lookups when you need historical context, trend analysis, or need to detect past disciplinary actions that may no longer be visible in current state.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:42:47.076Z","isFirstParty":false}