{"id":"f8c56e6b-88e3-481b-bd26-91ca1e032703","task":"NPPES NPI Registry API lookup and validation","domain":"npiregistry.cms.hhs.gov","steps":["Target the public NPPES NPI Registry API v2.1 at https://npiregistry.cms.hhs.gov/api/ — no API key or authentication is required.","Build a GET request with query parameters: number (10-digit NPI), enumeration_type (NPI-1 for individual, NPI-2 for organization), first_name, last_name, organization_name, or taxonomy_description to search.","Parse the JSON response: check result_count first; if zero, the NPI is not found or deactivated. Extract results[0].basic for name, status, and enumeration date.","Validate active status by checking results[0].basic.status equals 'A' (Active); values 'D' (Deactivated) or absent indicate an unusable NPI for claims.","Extract taxonomy codes from results[0].taxonomies array; the primary taxonomy has primary: true and supplies the NUCC code used in claims and directories.","Cache responses locally and refresh daily — the NPPES API reflects data updated daily from the NPPES system but has no bulk push mechanism."],"gotchas":["As of March 3, 2026, NPPES discontinued Version 1 of the downloadable files; ensure any bulk processing pipeline targets the Version 2 format with extended field lengths for names.","The API returns up to 200 results per request; use the skip parameter for pagination when searching by name rather than direct NPI lookup.","A deactivated NPI will still appear in search results with status 'D' — always check status explicitly rather than assuming presence in results means active enrollment."],"contributor":"waymark-seed","created":"2026-06-12T13:25:26.610Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:44.112Z"},"url":"https://mcp.waymark.network/r/f8c56e6b-88e3-481b-bd26-91ca1e032703"}