npi-providers-mcp-server

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['npis'], 'properties': {'npis': {'anyOf': [{'type': 'string', 'pattern': '^\\d{10}$', 'description': 'A 10-digit National Provider Identifier whose last digit is its check digit (Luhn over the number prefixed with 80840).'}, {'type': 'array', 'items': {'type': 'string', 'pattern': '^\\d{10}$', 'description': 'A 10-digit National Provider Identifier whose last digit is its check digit (Luhn over the number prefixed with 80840).'}, 'maxItems': 10, 'minItems': 1, 'description': 'An array of up to 10 ten-digit NPIs.'}], 'description': '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.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['found', 'notFound', 'errored', 'invalid', 'totalCount']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['none_found', 'invalid_npi_format'], 'description': 'Machine-readable failure mode. Declared by this tool: `none_found`: Every requested NPI with a valid check digit returned a confirmed no-record response â\x80\x94 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.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'found': {'type': 'array', 'items': {'type': 'object', 'required': ['npi', 'type', 'status', 'name', 'taxonomies', 'addresses', 'practiceLocations', 'identifiers', 'otherNames', 'endpoints'], 'properties': {'npi': {'type': 'string', 'description': '10-digit National Provider Identifier.'}, 'sex': {'type': 'string', 'description': 'Sex code, for individuals, when present.'}, 'name': {'type': 'string', 'description': 'Assembled "First Last" or organization name.'}, 'type': {'enum': ['individual', 'organization'], 'type': 'string', 'description': 'Enumeration type (NPI-1 vs NPI-2).'}, 'status': {'enum': ['active', 'deactivated'], 'type': 'string', 'description': 'Registry status â\x80\x94 never treat a deactivated NPI as current.'}, 'lastName': {'type': 'string', 'description': 'Last name, for individuals.'}, 'addresses': {'type': 'array', 'items': {'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'City.'}, 'line1': {'type': 'string', 'description': 'Address line 1.'}, 'line2': {'type': 'string', 'description': 'Address line 2.'}, 'state': {'type': 'string', 'description': 'State.'}, 'purpose': {'type': 'string', 'description': 'Address purpose: LOCATION (practice) or MAILING. Only LOCATION rows are kept for individual providers; organizations also carry MAILING.'}, 'faxNumber': {'type': 'string', 'description': 'Fax number, when present.'}, 'postalCode': {'type': 'string', 'description': 'Postal/ZIP code.'}, 'addressType': {'type': 'string', 'description': 'Address type (DOM domestic or FOR foreign).'}, 'countryCode': {'type': 'string', 'description': 'ISO country code.'}, 'countryName': {'type': 'string', 'description': 'Country name.'}, 'telephoneNumber': {'type': 'string', 'description': 'Telephone number, when present.'}}, 'description': 'A practice (LOCATION) address, or an organization mailing address.', 'additionalProperties': False}, 'description': 'Registry addresses. Only LOCATION (practice) rows are kept for individual providers â\x80\x94 their mailing address is withheld; organizations carry both LOCATION and MAILING rows.'}, 'endpoints': {'type': 'array', 'items': {'type': 'object', 'required': ['endpoint'], 'properties': {'use': {'type': 'string', 'description': 'Endpoint use code (e.g. "HIE"), when present.'}, 'city': {'type': 'string', 'description': 'Endpoint city, when present.'}, 'line1': {'type': 'string', 'description': 'Endpoint address line 1, when present.'}, 'line2': {'type': 'string', 'description': 'Endpoint address line 2, when present.'}, 'state': {'type': 'string', 'description': 'Endpoint state, when present.'}, 'endpoint': {'type': 'string', 'description': 'The endpoint URI/address.'}, 'postalCode': {'type': 'string', 'description': 'Endpoint postal/ZIP code, when present.'}, 'addressType': {'type': 'string', 'description': 'Endpoint address type (DOM/FOR), when present.'}, 'affiliation': {'type': 'string', 'description': 'Whether the endpoint is affiliated with an organization (Y/N), when present.'}, 'contentType': {'type': 'string', 'description': 'Endpoint content type code, when present.'}, 'countryCode': {'type': 'string', 'description': 'Endpoint ISO country code, when present.'}, 'countryName': {'type': 'string', 'description': 'Endpoint country name, when present.'}, 'endpointType': {'type': 'string', 'description': 'Endpoint type code (e.g. "DIRECT", "FHIR").'}, 'useDescription': {'type': 'string', 'description': 'Endpoint use description, when present.'}, 'affiliationName': {'type': 'string', 'description': 'Name of the affiliated organization, when present.'}, 'endpointDescription': {'type': 'string', 'description': 'Free-text description of the endpoint (e.g. "Carequality"), when present.'}, 'useOtherDescription': {'type': 'string', 'description': 'What the endpoint is used for when the use code is OTHER, when present.'}, 'contentTypeDescription': {'type': 'string', 'description': 'Endpoint content type description, when present.'}, 'contentOtherDescription': {'type': 'string', 'description': 'The content the endpoint carries when the content type is OTHER (e.g. "C-CDA"), when present.'}, 'endpointTypeDescription': {'type': 'string', 'description': 'Endpoint type description.'}}, 'description': 'A FHIR or Direct messaging endpoint with its routing address and context.', 'additionalProperties': False}, 'description': 'FHIR / Direct endpoints, when present.'}, 'firstName': {'type': 'string', 'description': 'First name, for individuals.'}, 'credential': {'type': 'string', 'description': 'Credential (e.g. "MD"), when present.'}, 'middleName': {'type': 'string', 'description': 'Middle name, when present.'}, 'namePrefix': {'type': 'string', 'description': 'Name prefix (e.g. "Dr."), when present.'}, 'nameSuffix': {'type': 'string', 'description': 'Name suffix (e.g. "Jr."), when present.'}, 'otherNames': {'type': 'array', 'items': {'type': 'object', 'properties': {'type': {'type': 'string', 'description': 'Other-name type (former name, DBA, etc.).'}, 'prefix': {'type': 'string', 'description': 'Name prefix, when present.'}, 'suffix': {'type': 'string', 'description': 'Name suffix, when present.'}, 'lastName': {'type': 'string', 'description': 'Last name, for individuals.'}, 'firstName': {'type': 'string', 'description': 'First name, for individuals.'}, 'credential': {'type': 'string', 'description': 'Credential, when present.'}, 'middleName': {'type': 'string', 'description': 'Middle name, for individuals, when present.'}, 'organizationName': {'type': 'string', 'description': 'Organization name, for organizations.'}}, 'description': 'A former or alternate name.', 'additionalProperties': False}, 'description': 'Former / alternate names, when present.'}, 'taxonomies': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'primary'], 'properties': {'code': {'type': 'string', 'description': 'Taxonomy code.'}, 'state': {'type': 'string', 'description': 'License state for this taxonomy, when present.'}, 'license': {'type': 'string', 'description': 'License number for this taxonomy, when present.'}, 'primary': {'type': 'boolean', 'description': "Whether this is the provider's primary taxonomy."}, 'description': {'type': 'string', 'description': 'Taxonomy description.'}, 'taxonomyGroup': {'type': 'string', 'description': 'Taxonomy group, when present.'}}, 'description': 'A taxonomy (specialty) on the record.', 'additionalProperties': False}, 'description': 'All taxonomies (specialties) on the record.'}, 'identifiers': {'type': 'array', 'items': {'type': 'object', 'required': ['identifier'], 'properties': {'code': {'type': 'string', 'description': 'Identifier type code.'}, 'state': {'type': 'string', 'description': 'Associated state, when present.'}, 'issuer': {'type': 'string', 'description': 'Issuing organization, when present.'}, 'identifier': {'type': 'string', 'description': 'The secondary identifier value.'}, 'description': {'type': 'string', 'description': 'Identifier type description (e.g. "MEDICAID").'}}, 'description': 'A secondary identifier (Medicaid, etc.).', 'additionalProperties': False}, 'description': 'Secondary identifiers (Medicaid, etc.), when present.'}, 'lastUpdated': {'type': 'string', 'description': 'Date the record was last updated.'}, 'createdEpoch': {'type': 'number', 'description': 'Record creation timestamp, epoch milliseconds, when present.'}, 'soleProprietor': {'type': 'string', 'description': 'Sole-proprietor flag (YES/NO), when present.'}, 'enumerationDate': {'type': 'string', 'description': 'Date the NPI was enumerated.'}, 'lastUpdatedEpoch': {'type': 'number', 'description': 'Record last-update timestamp, epoch milliseconds, when present.'}, 'organizationName': {'type': 'string', 'description': 'Organization legal name, for organizations.'}, 'certificationDate': {'type': 'string', 'description': 'Certification date, when present.'}, 'practiceLocations': {'type': 'array', 'items': {'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'City.'}, 'line1': {'type': 'string', 'description': 'Address line 1.'}, 'line2': {'type': 'string', 'description': 'Address line 2.'}, 'state': {'type': 'string', 'description': 'State.'}, 'purpose': {'type': 'string', 'description': 'Address purpose: LOCATION (practice) or MAILING. Only LOCATION rows are kept for individual providers; organizations also carry MAILING.'}, 'faxNumber': {'type': 'string', 'description': 'Fax number, when present.'}, 'postalCode': {'type': 'string', 'description': 'Postal/ZIP code.'}, 'addressType': {'type': 'string', 'description': 'Address type (DOM domestic or FOR foreign).'}, 'countryCode': {'type': 'string', 'description': 'ISO country code.'}, 'countryName': {'type': 'string', 'description': 'Country name.'}, 'telephoneNumber': {'type': 'string', 'description': 'Telephone number, when present.'}}, 'description': 'A practice (LOCATION) address, or an organization mailing address.', 'additionalProperties': False}, 'description': 'Additional practice locations, when present.'}, 'authorizedOfficial': {'type': 'object', 'properties': {'title': {'type': 'string', 'description': 'Authorized official title or position.'}, 'lastName': {'type': 'string', 'description': 'Authorized official last name.'}, 'firstName': {'type': 'string', 'description': 'Authorized official first name.'}, 'credential': {'type': 'string', 'description': 'Authorized official credential.'}, 'middleName': {'type': 'string', 'description': 'Authorized official middle name.'}, 'namePrefix': {'type': 'string', 'description': 'Authorized official name prefix, when present.'}, 'nameSuffix': {'type': 'string', 'description': 'Authorized official name suffix, when present.'}, 'telephoneNumber': {'type': 'string', 'description': 'Authorized official telephone number.'}}, 'description': 'Authorized official block, for organizations.', 'additionalProperties': False}, 'organizationalSubpart': {'type': 'string', 'description': 'Organizational subpart flag, for organizations.'}}, 'description': "A decoded NPPES provider record â\x80\x94 the registry's professional-practice data. Only LOCATION address rows are kept for individual providers.", 'additionalProperties': False}, 'description': 'Decoded records for NPIs that resolved.'}, 'notice': {'type': 'string', 'description': 'Guidance when some NPIs failed the check digit, returned no record, or hit an upstream error.'}, 'errored': {'type': 'array', 'items': {'type': 'object', 'required': ['npi', 'reason'], 'properties': {'npi': {'type': 'string', 'description': 'The requested NPI whose lookup failed operationally.'}, 'reason': {'type': 'string', 'description': 'The upstream failure reason (service unavailable, timeout, etc.).'}}, 'description': 'A requested NPI whose lookup failed with an upstream error.', 'additionalProperties': False}, 'description': 'NPIs whose lookups failed with an upstream/transport error (service unavailable, timeout) â\x80\x94 distinct from a confirmed miss in notFound. These are unresolved, not absent; retry them.'}, 'invalid': {'type': 'array', 'items': {'type': 'object', 'required': ['npi', 'reason'], 'properties': {'npi': {'type': 'string', 'description': 'The requested NPI that failed the check digit.'}, 'reason': {'type': 'string', 'description': 'Why the NPI was rejected.'}}, 'description': 'A requested NPI that failed the NPI check digit.', 'additionalProperties': False}, 'description': 'NPIs that failed the NPI check digit â\x80\x94 not valid NPIs, usually a typo. They were never looked up, so they are neither confirmed misses nor upstream failures.'}, 'notFound': {'type': 'array', 'items': {'type': 'object', 'required': ['npi', 'reason'], 'properties': {'npi': {'type': 'string', 'description': 'The requested NPI with no record.'}, 'reason': {'type': 'string', 'description': 'Why it returned nothing (e.g. no registry record).'}}, 'description': 'A requested NPI that returned no record.', 'additionalProperties': False}, 'description': 'NPIs with a valid check digit that returned no record (deactivated or never enumerated). A confirmed absence, not a failure.'}, 'totalCount': {'type': 'number', 'description': 'Number of provider records that resolved from the requested NPIs.'}}, 'additionalProperties': False}

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

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['matches']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit that was applied.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['no_match', 'missing_argument'], 'description': '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.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Number of entries returned.'}, 'notice': {'type': 'string', 'description': 'Guidance â\x80\x94 how to page a truncated result with skip, or how to broaden when nothing matched.'}, 'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'grouping', 'classification', 'displayName', 'section', 'status'], 'properties': {'code': {'type': 'string', 'description': 'NUCC taxonomy code, e.g. "207RC0000X".'}, 'notes': {'type': 'string', 'description': 'NUCC Notes: sources, revision history, and status remarks. Returned by mode "get" only, when NUCC records a note.'}, 'status': {'enum': ['active', 'inactive'], 'type': 'string', 'description': 'NUCC status. Inactive codes are no longer maintained: mode "resolve" excludes them, while "get" and "browse" return them.'}, 'section': {'enum': ['Individual', 'Non-Individual'], 'type': 'string', 'description': 'NPI enumeration scope: Individual (NPI-1) or Non-Individual (NPI-2).'}, 'grouping': {'type': 'string', 'description': 'Top-level grouping, e.g. "Allopathic & Osteopathic Physicians".'}, 'definition': {'type': 'string', 'description': 'Scope note / definition. Absent for a handful of codes.'}, 'replacedBy': {'type': 'string', 'description': 'For an inactive code, the active replacement code NUCC names, when it names one.'}, 'displayName': {'type': 'string', 'description': 'Human-readable display name, e.g. "Cardiovascular Disease Physician".'}, 'classification': {'type': 'string', 'description': 'Classification within the grouping, e.g. "Internal Medicine".'}, 'specialization': {'type': 'string', 'description': 'Specialization within the classification, e.g. "Cardiovascular Disease". Absent for top-level classification codes.'}}, 'description': 'A single NUCC taxonomy entry.', 'additionalProperties': False}, 'description': 'Matching taxonomy entries. For mode "get" this is the single requested entry; for "resolve"/"browse" it is the ranked/sorted matches up to limit.'}, 'truncated': {'type': 'boolean', 'description': 'True when the list was capped at `limit` (more entries may match).'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'city': {'type': 'string', 'pattern': '^[^*]*$|^[^*]{2,}\\*$', 'description': 'Practice-location city, case-insensitive. A trailing "*" after at least 2 characters matches every city starting with them (e.g. "SAN F*").'}, 'skip': {'type': 'integer', 'default': 0, 'maximum': 1000, 'minimum': 0, 'description': 'Results to skip for pagination (0â\x80\x931000). A full page names the next in nextPage.'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 200, 'minimum': 1, 'description': 'Maximum providers to return (1â\x80\x93200; the registry caps at 200).'}, 'state': {'anyOf': [{'type': 'string', 'const': ''}, {'type': 'string', 'pattern': '^[A-Z]{2}$', 'description': '2-letter state code (e.g. "WA").'}], 'description': '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.'}, 'last_name': {'type': 'string', 'description': 'Individual last name. Trailing wildcard "*" allowed with at least 2 leading characters.'}, 'specialty': {'type': 'string', 'description': '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.'}, 'first_name': {'type': 'string', 'description': 'Individual first name. Trailing wildcard "*" allowed with at least 2 leading characters.'}, 'name_search': {'type': 'string', 'description': "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."}, 'postal_code': {'type': 'string', 'pattern': '^[^*]*$|^\\d{2,9}\\*$', 'description': 'Practice-location ZIP code: 5 digits (also matching the ZIP+4 codes that extend it), 9 digits, or a 2â\x80\x939 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.'}, 'provider_type': {'enum': ['individual', 'organization'], 'type': 'string', 'description': '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).'}, 'organization_name': {'type': 'string', 'description': '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.'}, 'taxonomy_description': {'type': 'string', 'description': 'Exact NUCC taxonomy description for direct passthrough â\x80\x94 use when the taxonomy description is already known. Mutually exclusive with specialty.'}}, 'additionalProperties': False}

{'type': 'object', 'anyOf': [{'not': {'required': ['error']}, 'required': ['providers']}, {'required': ['error']}], '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'cap': {'type': 'number', 'description': 'The limit that was applied.'}, 'error': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'JSON-RPC error code for this failure.'}, 'data': {'type': 'object', 'properties': {'reason': {'type': 'string', 'examples': ['no_search_criteria', 'conflicting_specialty', 'mixed_provider_criteria', 'unresolved_specialty', 'invalid_search_field'], '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. `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.'}, 'recovery': {'type': 'object', 'required': ['hint'], 'properties': {'hint': {'type': 'string'}}, 'description': 'Actionable next step for the caller.', 'additionalProperties': {}}, 'retryable': {'type': 'boolean', 'description': 'Whether retrying may succeed.'}}, 'additionalProperties': {}}, 'message': {'type': 'string', 'description': 'Human-readable description of what went wrong.'}}, 'description': 'Present when the call failed. Absent on success.', 'additionalProperties': {}}, 'shown': {'type': 'number', 'description': 'Number of providers returned.'}, 'notice': {'type': 'string', 'description': 'Guidance â\x80\x94 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.'}, 'nextPage': {'type': 'object', 'required': ['skip', 'limit'], 'properties': {'skip': {'type': 'number', 'description': 'The skip to send for the next page.'}, 'limit': {'type': 'number', 'description': 'The limit to send for the next page.'}}, '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) â\x80\x94 dedupe by NPI.', 'additionalProperties': False}, 'providers': {'type': 'array', 'items': {'type': 'object', 'required': ['npi', 'type', 'name', 'status'], 'properties': {'npi': {'type': 'string', 'description': '10-digit National Provider Identifier â\x80\x94 the chaining key for npi_get_provider.'}, 'city': {'type': 'string', 'description': 'Primary practice-location city when present.'}, 'name': {'type': 'string', 'description': 'Assembled "First Last" (individual) or organization name.'}, 'type': {'enum': ['individual', 'organization'], 'type': 'string', 'description': 'Provider enumeration type (NPI-1 vs NPI-2).'}, 'state': {'type': 'string', 'description': 'Primary practice-location state when present.'}, 'status': {'enum': ['active', 'deactivated'], 'type': 'string', 'description': 'Registry status â\x80\x94 never treat a deactivated NPI as current.'}, 'credential': {'type': 'string', 'description': 'Credential (e.g. "MD", "DO", "RN") when present.'}, 'postalCode': {'type': 'string', 'description': 'Primary practice-location postal/ZIP code when present.'}, 'matchedLocation': {'type': 'object', 'properties': {'city': {'type': 'string', 'description': 'City of the matching practice location.'}, 'state': {'type': 'string', 'description': 'State of the matching practice location.'}, 'postalCode': {'type': 'string', 'description': 'Postal/ZIP code of the matching practice location.'}}, 'description': 'The additional practice location that satisfied the requested city/state/postal_code. Present only when the primary practice location is elsewhere.', 'additionalProperties': False}, 'primaryTaxonomy': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string', 'description': 'Primary taxonomy code.'}, 'description': {'type': 'string', 'description': 'Primary taxonomy description.'}}, 'description': "The provider's primary taxonomy (the entry flagged primary, else the first listed).", 'additionalProperties': False}, 'matchedOtherName': {'type': 'object', 'required': ['name'], 'properties': {'name': {'type': 'string', 'description': 'The other name as "First Middle Last", or its organization name.'}, 'type': {'type': 'string', 'description': 'Registry name type, e.g. "Former Name", "Professional Name".'}}, '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).', 'additionalProperties': False}}, 'description': 'A compact provider row for disambiguation.', 'additionalProperties': False}, 'description': 'Matching provider rows (up to limit).'}, 'truncated': {'type': 'boolean', 'description': 'True when the NPPES page contained at least cap providers before location constraints were applied; more may match even when shown is below cap.'}, 'resolvedTaxonomies': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'description'], 'properties': {'code': {'type': 'string', 'description': 'Resolved NUCC taxonomy code.'}, 'description': {'type': 'string', 'description': 'Search-compatible NUCC specialization or classification for this candidate.'}}, 'additionalProperties': False}, 'description': 'Taxonomy candidates ranked for the specialty term. The first candidate supplies appliedTaxonomyDescription; a different candidate can be selected through taxonomy_description.'}, 'continuationPostalCodes': {'type': 'array', 'items': {'type': 'string', 'description': 'A trailing-"*" postal_code prefix.'}, '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 â\x80\x94 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).'}, 'appliedTaxonomyDescription': {'type': 'string', 'description': 'The exact NUCC specialization or classification used as the specialty filter.'}}, 'additionalProperties': False}