npi-providers-mcp-server

Previous value: -"Machine-readable failure mode. Declared by this tool: `no_match`: A get code matched no taxonomy entry, or a resolve query matched no active one (the message names any inactive codes it matched). `missing_argument`: The required query or code was present but blank after trimming. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_match`: A get code matched no taxonomy entry, a resolve query matched no active one (the message names any inactive codes it matched), or a resolve query was made only of generic words (\"doctor\", \"M.D.\", \"specialist\") that name no specialty. `missing_argument`: The required query or code was present but blank after trimming. Other values are possible when a failure originates below the handler."

Previous value: -"Practice-location city."New value: +"Practice-location city, case-insensitive. A trailing \"*\" after at least 2 characters matches every city starting with them (e.g. \"SAN F*\")."

Added value: +"^[^*]*$|^[^*]{2,}\\*$"

Previous value: -"Organization name (implies provider_type organization). Trailing wildcard \"*\" allowed with at least 2 leading characters."New value: +"Organization name (implies provider_type organization; cannot be combined with first_name, last_name, or name_search). Trailing wildcard \"*\" allowed with at least 2 leading characters."

Previous value: -"Practice-location postal/ZIP code (5 or 9 digits)."New value: +"Practice-location ZIP code: 5 digits (also matching the ZIP+4 codes that extend it), 9 digits, or a 2–9 digit prefix with one trailing \"*\" (e.g. \"98*\", \"981*\"). A ZIP+4 prefix (6+ digits) never matches a practice address recorded with only a 5-digit ZIP."

Added value: +"^[^*]*$|^\\d{2,9}\\*$"

Previous value: -"Restrict to individuals (NPI-1) or organizations (NPI-2). Omit to search both."New value: +"Restrict to individuals (NPI-1) or organizations (NPI-2). Omit to search both; when set, it must match the name fields (\"individual\" for first_name/last_name/name_search, \"organization\" for organization_name)."

Previous value: -"Results to skip for pagination (0–1000). Only the first 1200 matches are reachable; skip beyond 1000 silently returns the same window — narrow the query instead of paging further."New value: +"Results to skip for pagination (0–1000). A full page names the next in nextPage."

Added value: +{
+  "description": "Present only at the terminal window (a full page at skip 1000, limit 200): postal_code prefixes that continue the same search, each re-run from skip 0 with the same arguments — the notice gives the full procedure. Empty when no postal split remains (postal_code is already a 5-digit ZIP, a full ZIP+4, or not a numeric ZIP prefix).",
+  "items": {
+    "description": "A trailing-\"*\" postal_code prefix.",
+    "type": "string"
+  },
+  "type": "array"
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `no_search_criteria`: No effective search criterion was provided. `conflicting_specialty`: Both specialty and taxonomy_description were supplied. `unresolved_specialty`: The specialty term matched no active NUCC taxonomy (the message names any inactive codes it matched). `invalid_search_field`: The registry returned a field error (e.g. wildcard under 2 characters, bad provider type). Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_search_criteria`: No effective search criterion was provided. `conflicting_specialty`: Both specialty and taxonomy_description were supplied. `mixed_provider_criteria`: Individual criteria (first_name, last_name, name_search) were combined with organization criteria (organization_name), directly or through provider_type. `unresolved_specialty`: The specialty term matched no active NUCC taxonomy (the message names any inactive codes it matched), or was made only of generic words (\"doctor\", \"M.D.\", \"specialist\") that name no specialty. `invalid_search_field`: The registry returned a field error (e.g. wildcard under 2 characters, bad provider type). Other values are possible when a failure originates below the handler."

Previous value: -[
-  "no_search_criteria",
-  "conflicting_specialty",
-  "unresolved_specialty",
-  "invalid_search_field"
-]New value: +[
+  "no_search_criteria",
+  "conflicting_specialty",
+  "mixed_provider_criteria",
+  "unresolved_specialty",
+  "invalid_search_field"
+]

Added value: +{
+  "additionalProperties": false,
+  "description": "The next page: re-run the same arguments with this skip and limit. Present after a full page while rows remain reachable. When skip + limit passes 1000 it is skip 1000, limit 200, whose leading rows repeat rows already returned (the notice says how many) — dedupe by NPI.",
+  "properties": {
+    "limit": {
+      "description": "The limit to send for the next page.",
+      "type": "number"
+    },
+    "skip": {
+      "description": "The skip to send for the next page.",
+      "type": "number"
+    }
+  },
+  "required": [
+    "skip",
+    "limit"
+  ],
+  "type": "object"
+}

Previous value: -"Guidance — pagination ceiling, page-size-not-total caveat, or how to broaden an empty result."New value: +"Guidance — the page-size-not-total caveat, the next page or terminal-window continuation procedure, other-name and location-filter counts, or how to broaden an empty result."

Added value: +{
+  "additionalProperties": false,
+  "description": "The other (former, professional, DBA, or alternate) name this row matched the name search through. Present only when the current name fails a requested last_name, organization_name, or wildcard first_name and this other name satisfies it (case-insensitive, ignoring punctuation and spaces, trailing \"*\" as a prefix). An exact first_name alone never marks a row: the registry also matches first-name variants (Bob for Robert).",
+  "properties": {
+    "name": {
+      "description": "The other name as \"First Middle Last\", or its organization name.",
+      "type": "string"
+    },
+    "type": {
+      "description": "Registry name type, e.g. \"Former Name\", \"Professional Name\".",
+      "type": "string"
+    }
+  },
+  "required": [
+    "name"
+  ],
+  "type": "object"
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `no_match`: A resolve query or get code matched no taxonomy entry. `missing_argument`: The required query or code was present but blank after trimming. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_match`: A get code matched no taxonomy entry, or a resolve query matched no active one (the message names any inactive codes it matched). `missing_argument`: The required query or code was present but blank after trimming. Other values are possible when a failure originates below the handler."

Added value: +{
+  "description": "NUCC Notes: sources, revision history, and status remarks. Returned by mode \"get\" only, when NUCC records a note.",
+  "type": "string"
+}

Added value: +{
+  "description": "For an inactive code, the active replacement code NUCC names, when it names one.",
+  "type": "string"
+}

Added value: +{
+  "description": "NUCC status. Inactive codes are no longer maintained: mode \"resolve\" excludes them, while \"get\" and \"browse\" return them.",
+  "enum": [
+    "active",
+    "inactive"
+  ],
+  "type": "string"
+}

Previous value: -[
-  "code",
-  "grouping",
-  "classification",
-  "displayName",
-  "section"
-]New value: +[
+  "code",
+  "grouping",
+  "classification",
+  "displayName",
+  "section",
+  "status"
+]

Previous value: -"Plain-language specialty (e.g. \"pediatric cardiologist\"), resolved through the bundled NUCC taxonomy to exact descriptions before searching. The matched taxonomy is echoed in the result. Mutually exclusive with taxonomy_description."New value: +"Plain-language specialty (e.g. \"pediatric cardiologist\"), resolved through the bundled NUCC taxonomy to exact descriptions before searching. Codes NUCC marks inactive are never resolved. The matched taxonomy is echoed in the result. Mutually exclusive with taxonomy_description."

Previous value: -"Machine-readable failure mode. Declared by this tool: `no_search_criteria`: No effective search criterion was provided. `conflicting_specialty`: Both specialty and taxonomy_description were supplied. `unresolved_specialty`: The specialty term matched no NUCC taxonomy. `invalid_search_field`: The registry returned a field error (e.g. wildcard under 2 characters, bad provider type). Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_search_criteria`: No effective search criterion was provided. `conflicting_specialty`: Both specialty and taxonomy_description were supplied. `unresolved_specialty`: The specialty term matched no active NUCC taxonomy (the message names any inactive codes it matched). `invalid_search_field`: The registry returned a field error (e.g. wildcard under 2 characters, bad provider type). Other values are possible when a failure originates below the handler."

Previous value: -[
-  {
-    "description": "A 10-digit National Provider Identifier.",
-    "pattern": "^\\d{10}$",
-    "type": "string"
-  },
-  {
-    "description": "An array of up to 10 ten-digit NPIs.",
-    "items": {
-      "description": "A 10-digit National Provider Identifier.",
-      "pattern": "^\\d{10}$",
-      "type": "string"
-    },
-    "maxItems": 10,
-    "minItems": 1,
-    "type": "array"
-  }
-]New value: +[
+  {
+    "description": "A 10-digit National Provider Identifier whose last digit is its check digit (Luhn over the number prefixed with 80840).",
+    "pattern": "^\\d{10}$",
+    "type": "string"
+  },
+  {
+    "description": "An array of up to 10 ten-digit NPIs.",
+    "items": {
+      "description": "A 10-digit National Provider Identifier whose last digit is its check digit (Luhn over the number prefixed with 80840).",
+      "pattern": "^\\d{10}$",
+      "type": "string"
+    },
+    "maxItems": 10,
+    "minItems": 1,
+    "type": "array"
+  }
+]

Previous value: -"A single 10-digit NPI, or an array of up to 10. Each is validated as exactly 10 digits before any API call."New value: +"A single 10-digit NPI, or an array of up to 10. Each must be exactly 10 digits; each is also checked against its NPI check digit before any API call, and one that fails is reported in invalid."

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "found",
-      "notFound",
-      "errored",
-      "totalCount"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "found",
+      "notFound",
+      "errored",
+      "invalid",
+      "totalCount"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Previous value: -"Machine-readable failure mode. Declared by this tool: `none_found`: Every requested NPI returned a confirmed no-record response — none failed with an upstream error (those surface as the underlying service/timeout error instead). Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `none_found`: Every requested NPI with a valid check digit returned a confirmed no-record response — none failed with an upstream error (those surface as the underlying service/timeout error instead). `invalid_npi_format`: Every requested NPI failed the NPI check digit, so none was looked up. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "none_found"
-]New value: +[
+  "none_found",
+  "invalid_npi_format"
+]

Previous value: -"Fully decoded records for NPIs that resolved."New value: +"Decoded records for NPIs that resolved."

Previous value: -"A fully decoded NPPES provider record."New value: +"A decoded NPPES provider record — the registry's professional-practice data. Only LOCATION address rows are kept for individual providers."

Previous value: -"All practice and mailing addresses."New value: +"Registry addresses. Only LOCATION (practice) rows are kept for individual providers — their mailing address is withheld; organizations carry both LOCATION and MAILING rows."

Previous value: -"A practice or mailing address."New value: +"A practice (LOCATION) address, or an organization mailing address."

Previous value: -"Address purpose (LOCATION or MAILING)."New value: +"Address purpose: LOCATION (practice) or MAILING. Only LOCATION rows are kept for individual providers; organizations also carry MAILING."

Added value: +{
+  "description": "The content the endpoint carries when the content type is OTHER (e.g. \"C-CDA\"), when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Free-text description of the endpoint (e.g. \"Carequality\"), when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Endpoint address line 2, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "What the endpoint is used for when the use code is OTHER, when present.",
+  "type": "string"
+}

Previous value: -"A practice or mailing address."New value: +"A practice (LOCATION) address, or an organization mailing address."

Previous value: -"Address purpose (LOCATION or MAILING)."New value: +"Address purpose: LOCATION (practice) or MAILING. Only LOCATION rows are kept for individual providers; organizations also carry MAILING."

Added value: +{
+  "description": "NPIs that failed the NPI check digit — not valid NPIs, usually a typo. They were never looked up, so they are neither confirmed misses nor upstream failures.",
+  "items": {
+    "additionalProperties": false,
+    "description": "A requested NPI that failed the NPI check digit.",
+    "properties": {
+      "npi": {
+        "description": "The requested NPI that failed the check digit.",
+        "type": "string"
+      },
+      "reason": {
+        "description": "Why the NPI was rejected.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "npi",
+      "reason"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Previous value: -"NPIs that were well-formed but returned no record (deactivated or never enumerated). A confirmed absence, not a failure."New value: +"NPIs with a valid check digit that returned no record (deactivated or never enumerated). A confirmed absence, not a failure."

Previous value: -"Guidance when some or all NPIs returned nothing."New value: +"Guidance when some NPIs failed the check digit, returned no record, or hit an upstream error."

Previous value: -"Practice-location city when present."New value: +"Primary practice-location city when present."

Added value: +{
+  "additionalProperties": false,
+  "description": "The additional practice location that satisfied the requested city/state/postal_code. Present only when the primary practice location is elsewhere.",
+  "properties": {
+    "city": {
+      "description": "City of the matching practice location.",
+      "type": "string"
+    },
+    "postalCode": {
+      "description": "Postal/ZIP code of the matching practice location.",
+      "type": "string"
+    },
+    "state": {
+      "description": "State of the matching practice location.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Previous value: -"Practice-location postal/ZIP code when present."New value: +"Primary practice-location postal/ZIP code when present."

Previous value: -"Practice-location state when present."New value: +"Primary practice-location state when present."

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "found",
+      "notFound",
+      "errored",
+      "totalCount"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `none_found`: Every requested NPI returned a confirmed no-record response — none failed with an upstream error (those surface as the underlying service/timeout error instead). Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "none_found"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "found",
-  "notFound",
-  "errored",
-  "totalCount"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "limit": {
+        "default": 20,
+        "description": "Maximum matching entries to return (1–50).",
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "mode": {
+        "const": "resolve",
+        "description": "Resolve a plain-language specialty to taxonomy codes.",
+        "type": "string"
+      },
+      "query": {
+        "description": "The plain-language specialty term to resolve, e.g. \"pediatric cardiologist\".",
+        "minLength": 1,
+        "type": "string"
+      },
+      "skip": {
+        "default": 0,
+        "description": "Entries to skip before the page (0–1000). Keep the same query and limit, then raise skip by limit each call.",
+        "maximum": 1000,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "mode",
+      "query"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "code": {
+        "description": "The exact NUCC taxonomy code, e.g. \"207RC0000X\".",
+        "minLength": 1,
+        "type": "string"
+      },
+      "mode": {
+        "const": "get",
+        "description": "Fetch one exact taxonomy entry by code.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "mode",
+      "code"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "grouping": {
+        "description": "Filter to a top-level grouping by case-insensitive substring, e.g. \"physicians\".",
+        "type": "string"
+      },
+      "limit": {
+        "default": 20,
+        "description": "Maximum entries to return (1–50).",
+        "maximum": 50,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "mode": {
+        "const": "browse",
+        "description": "Browse the taxonomy hierarchy.",
+        "type": "string"
+      },
+      "section": {
+        "description": "Filter by NPI section: Individual (NPI-1) or Non-Individual (NPI-2).",
+        "enum": [
+          "Individual",
+          "Non-Individual"
+        ],
+        "type": "string"
+      },
+      "skip": {
+        "default": 0,
+        "description": "Entries to skip before the page (0–1000). Keep the same filters and limit, then raise skip by limit each call.",
+        "maximum": 1000,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "mode"
+    ],
+    "type": "object"
+  }
+]

Removed value: -{
-  "code": {
-    "description": "For mode \"get\": the exact NUCC taxonomy code (e.g. \"207RC0000X\").",
-    "type": "string"
-  },
-  "grouping": {
-    "description": "For mode \"browse\": filter to a top-level grouping by case-insensitive substring (e.g. \"physicians\").",
-    "type": "string"
-  },
-  "limit": {
-    "default": 20,
-    "description": "Maximum entries to return for resolve/browse (1–50). Ignored for get.",
-    "maximum": 50,
-    "minimum": 1,
-    "type": "integer"
-  },
-  "mode": {
-    "description": "resolve: plain term → codes. get: exact code → entry. browse: walk the hierarchy.",
-    "enum": [
-      "resolve",
-      "get",
-      "browse"
-    ],
-    "type": "string"
-  },
-  "query": {
-    "description": "For mode \"resolve\": the plain-language specialty term to resolve (e.g. \"pediatric cardiologist\").",
-    "type": "string"
-  },
-  "section": {
-    "description": "For mode \"browse\": filter by NPI section — Individual (NPI-1) or Non-Individual (NPI-2).",
-    "enum": [
-      "Individual",
-      "Non-Individual"
-    ],
-    "type": "string"
-  },
-  "skip": {
-    "default": 0,
-    "description": "Entries to skip before the page, for paging past a truncated resolve/browse result (0–1000). Keep the same query/filters and limit, raise skip by limit each call. Ignored for get.",
-    "maximum": 1000,
-    "minimum": 0,
-    "type": "integer"
-  }
-}

Removed value: -[
-  "mode"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "matches"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `no_match`: A resolve query or get code matched no taxonomy entry. `missing_argument`: The required query or code was present but blank after trimming. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "no_match",
+            "missing_argument"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "matches"
-]

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"Convenience shortcut: a single person's name, split into first/last heuristically. For precise control use first_name/last_name."New value: +"One person's name. The first token becomes first_name and the last token becomes last_name; use first_name/last_name when middle names or multi-part surnames matter."

Previous value: -"2-letter state code (e.g. \"WA\"). The registry rejects state-only searches — pair it with another criterion. Blank values from form-based clients are treated as omitted."New value: +"2-letter state code (e.g. \"WA\"). The registry rejects state-only searches, so another criterion is required. A blank value is treated as omitted."

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "providers"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Previous value: -"The single taxonomy_description sent to the registry (from specialty resolution or the raw escape hatch)."New value: +"The exact NUCC specialization or classification used as the specialty filter."

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `no_search_criteria`: No effective search criterion was provided. `conflicting_specialty`: Both specialty and taxonomy_description were supplied. `unresolved_specialty`: The specialty term matched no NUCC taxonomy. `invalid_search_field`: The registry returned a field error (e.g. wildcard under 2 characters, bad provider type). Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "no_search_criteria",
+            "conflicting_specialty",
+            "unresolved_specialty",
+            "invalid_search_field"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Previous value: -"The taxonomy candidates the specialty term resolved to; the first was sent to the registry. Re-run with taxonomy_description to pick a different one."New value: +"Taxonomy candidates ranked for the specialty term. The first candidate supplies appliedTaxonomyDescription; a different candidate can be selected through taxonomy_description."

Previous value: -"The taxonomy description (specialization or classification) the registry matched on — the value sent as taxonomy_description."New value: +"Search-compatible NUCC specialization or classification for this candidate."

Previous value: -"True when the returned page hit the limit — more may match."New value: +"True when the NPPES page contained at least cap providers before location constraints were applied; more may match even when shown is below cap."

Removed value: -[
-  "providers"
-]

Added value: +{
+  "default": 0,
+  "description": "Entries to skip before the page, for paging past a truncated resolve/browse result (0–1000). Keep the same query/filters and limit, raise skip by limit each call. Ignored for get.",
+  "maximum": 1000,
+  "minimum": 0,
+  "type": "integer"
+}

Previous value: -"Guidance when nothing matched — suggests broadening or browsing the hierarchy."New value: +"Guidance — how to page a truncated result with skip, or how to broaden when nothing matched."

Added value: +{
+  "description": "NPIs whose lookups failed with an upstream/transport error (service unavailable, timeout) — distinct from a confirmed miss in notFound. These are unresolved, not absent; retry them.",
+  "items": {
+    "additionalProperties": false,
+    "description": "A requested NPI whose lookup failed with an upstream error.",
+    "properties": {
+      "npi": {
+        "description": "The requested NPI whose lookup failed operationally.",
+        "type": "string"
+      },
+      "reason": {
+        "description": "The upstream failure reason (service unavailable, timeout, etc.).",
+        "type": "string"
+      }
+    },
+    "required": [
+      "npi",
+      "reason"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Authorized official name prefix, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Authorized official name suffix, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Record creation timestamp, epoch milliseconds, when present.",
+  "type": "number"
+}

Previous value: -"A FHIR or Direct messaging endpoint."New value: +"A FHIR or Direct messaging endpoint with its routing address and context."

Added value: +{
+  "description": "Endpoint address type (DOM/FOR), when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Whether the endpoint is affiliated with an organization (Y/N), when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Name of the affiliated organization, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Endpoint city, when present.",
+  "type": "string"
+}

Previous value: -"Endpoint content type, when present."New value: +"Endpoint content type code, when present."

Added value: +{
+  "description": "Endpoint content type description, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Endpoint ISO country code, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Endpoint country name, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Endpoint address line 1, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Endpoint postal/ZIP code, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Endpoint state, when present.",
+  "type": "string"
+}

Previous value: -"Endpoint use, when present."New value: +"Endpoint use code (e.g. \"HIE\"), when present."

Added value: +{
+  "description": "Endpoint use description, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Record last-update timestamp, epoch milliseconds, when present.",
+  "type": "number"
+}

Added value: +{
+  "description": "Middle name, for individuals, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Name prefix, when present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Name suffix, when present.",
+  "type": "string"
+}

Previous value: -"NPIs that were well-formed but returned no record (deactivated or never enumerated)."New value: +"NPIs that were well-formed but returned no record (deactivated or never enumerated). A confirmed absence, not a failure."

Previous value: -[
-  "found",
-  "notFound",
-  "totalCount"
-]New value: +[
+  "found",
+  "notFound",
+  "errored",
+  "totalCount"
+]

Added value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "description": "2-letter state code (e.g. \"WA\").",
+    "pattern": "^[A-Z]{2}$",
+    "type": "string"
+  }
+]

Previous value: -"2-letter state code (e.g. \"WA\"). The registry rejects state-only searches — pair it with another criterion."New value: +"2-letter state code (e.g. \"WA\"). The registry rejects state-only searches — pair it with another criterion. Blank values from form-based clients are treated as omitted."

Removed value: -"^[A-Z]{2}$"

Removed value: -"string"

Added value: +{
+  "description": "Practice-location postal/ZIP code when present.",
+  "type": "string"
+}