feat(analyzer): Add Healthcare identifiers recognizer

CHANGELOG.md

@@ -6,6 +6,8 @@ All notable changes to this project will be documented in this file.
 
 ### Analyzer
 #### Added
+- Added a disabled-by-default US health insurance member ID (`US_HEALTH_INSURANCE_MEMBER_ID`) recognizer requiring healthcare or insurance context.
+- Added disabled-by-default US healthcare administrative ID recognizers for claim numbers, prior authorization numbers, prescription numbers, provider tax IDs, and referral numbers.
 - Added `UuidRecognizer` (generic, entity type `UUID`) to detect UUIDs in the standard 8-4-4-4-12 hyphenated hexadecimal format, covering RFC 4122 versions 1-5 and RFC 9562 versions 6-8. Validates version and variant nibbles and filters the nil UUID to reduce false positives.
 - South African ID number (`ZA_ID_NUMBER`) recognizer for the 13-digit national identity number, using pattern matching, context words, birth-date validation, and Luhn checksum validation. Disabled by default.
 - South African recognizers for `ZA_PASSPORT`, `ZA_INCOME_TAX_NUMBER`, `ZA_DRIVER_LICENSE`, `ZA_VAT_NUMBER`, `ZA_COMPANY_REGISTRATION`, `ZA_TRAFFIC_REGISTER_NUMBER`, `ZA_LICENSE_PLATE`, `ZA_MOBILE_NUMBER`, and `ZA_TELEPHONE_NUMBER`. All disabled by default.

docs/supported_entities.md

@@ -34,9 +34,15 @@ For more information, refer to the [adding new recognizers documentation](analyz
 |US_BANK_NUMBER|A US bank account number is between 8 to 17 digits.|Pattern match and context|
 |US_DRIVER_LICENSE|A US driver license according to <https://ntsi.com/drivers-license-format/>|Pattern match and context|
 |US_ITIN | US Individual Taxpayer Identification Number (ITIN). Nine digits that start with a "9" and contain a "7" or "8" as the 4 digit.|Pattern match and context|
+|US_CLAIM_NUMBER|A US healthcare claim identifier used in billing and claims processing.|Pattern match, context enhancement, and entity threshold|
+|US_HEALTH_INSURANCE_MEMBER_ID|A US health insurance member or subscriber identifier printed on an insurance card. Healthcare or insurance context increases detection confidence.|Pattern match, context enhancement, and entity threshold|
 |US_MBI|A US Medicare Beneficiary Identifier (MBI) with 11 alphanumeric characters.|Pattern match and context|
 |US_NPI|A US National Provider Identifier (NPI) is a 10-digit number issued to healthcare providers by CMS under HIPAA.|Pattern match, context and checksum|
 |US_PASSPORT |A US passport number with 9 digits.|Pattern match and context|
+|US_PRESCRIPTION_NUMBER|A US prescription or pharmacy order identifier.|Pattern match, context enhancement, and entity threshold|
+|US_PRIOR_AUTHORIZATION_NUMBER|A US prior authorization identifier used for treatment or drug approval requests.|Pattern match, context enhancement, and entity threshold|
+|US_PROVIDER_TAX_ID|A US provider organization tax identifier (TIN/EIN) used in healthcare billing workflows.|Pattern match, context enhancement, and entity threshold|
+|US_REFERRAL_NUMBER|A US healthcare referral identifier, including specialty or infusion referral numbers.|Pattern match, context enhancement, and entity threshold|
 |US_SSN|A US Social Security Number (SSN) with 9 digits.|Pattern match and context|
 
 ### UK

presidio-analyzer/presidio_analyzer/conf/default_recognizers.yaml

@@ -91,6 +91,48 @@ recognizers:
     enabled: false
     country_code: us
 
+  - name: UsHealthInsuranceMemberIdRecognizer
+    supported_languages:
+    - en
+    type: predefined
+    enabled: false
+    country_code: us
+
+  - name: UsPriorAuthorizationNumberRecognizer
+    supported_languages:
+    - en
+    type: predefined
+    enabled: false
+    country_code: us
+
+  - name: UsClaimNumberRecognizer
+    supported_languages:
+    - en
+    type: predefined
+    enabled: false
+    country_code: us
+
+  - name: UsPrescriptionNumberRecognizer
+    supported_languages:
+    - en
+    type: predefined
+    enabled: false
+    country_code: us
+
+  - name: UsReferralNumberRecognizer
+    supported_languages:
+    - en
+    type: predefined
+    enabled: false
+    country_code: us
+
+  - name: UsProviderTaxIdRecognizer
+    supported_languages:
+    - en
+    type: predefined
+    enabled: false
+    country_code: us
+
   - name: NhsRecognizer
     supported_languages: 
     - en

presidio-analyzer/presidio_analyzer/predefined_recognizers/__init__.py

@@ -157,6 +157,16 @@
 from .country_specific.us.medical_license_recognizer import MedicalLicenseRecognizer
 from .country_specific.us.us_bank_recognizer import UsBankRecognizer
 from .country_specific.us.us_driver_license_recognizer import UsLicenseRecognizer
+from .country_specific.us.us_health_insurance_member_id_recognizer import (
+    UsHealthInsuranceMemberIdRecognizer,
+)
+from .country_specific.us.us_healthcare_admin_recognizers import (
+    UsClaimNumberRecognizer,
+    UsPrescriptionNumberRecognizer,
+    UsPriorAuthorizationNumberRecognizer,
+    UsProviderTaxIdRecognizer,
+    UsReferralNumberRecognizer,
+)
 from .country_specific.us.us_itin_recognizer import UsItinRecognizer
 from .country_specific.us.us_mbi_recognizer import UsMbiRecognizer
 from .country_specific.us.us_npi_recognizer import UsNpiRecognizer
@@ -229,11 +239,17 @@
     "SgFinRecognizer",
     "UrlRecognizer",
     "UsBankRecognizer",
+    "UsClaimNumberRecognizer",
+    "UsHealthInsuranceMemberIdRecognizer",
     "UsItinRecognizer",
     "UsLicenseRecognizer",
     "UsMbiRecognizer",
     "UsNpiRecognizer",
     "UsPassportRecognizer",
+    "UsPrescriptionNumberRecognizer",
+    "UsPriorAuthorizationNumberRecognizer",
+    "UsProviderTaxIdRecognizer",
+    "UsReferralNumberRecognizer",
     "UsSsnRecognizer",
     "EsNifRecognizer",
     "SpacyRecognizer",

presidio-analyzer/presidio_analyzer/predefined_recognizers/country_specific/us/__init__.py

@@ -4,6 +4,16 @@
 from .medical_license_recognizer import MedicalLicenseRecognizer
 from .us_bank_recognizer import UsBankRecognizer
 from .us_driver_license_recognizer import UsLicenseRecognizer
+from .us_health_insurance_member_id_recognizer import (
+    UsHealthInsuranceMemberIdRecognizer,
+)
+from .us_healthcare_admin_recognizers import (
+    UsClaimNumberRecognizer,
+    UsPrescriptionNumberRecognizer,
+    UsPriorAuthorizationNumberRecognizer,
+    UsProviderTaxIdRecognizer,
+    UsReferralNumberRecognizer,
+)
 from .us_itin_recognizer import UsItinRecognizer
 from .us_mbi_recognizer import UsMbiRecognizer
 from .us_npi_recognizer import UsNpiRecognizer
@@ -15,9 +25,15 @@
     "UsItinRecognizer",
     "UsBankRecognizer",
     "UsLicenseRecognizer",
+    "UsClaimNumberRecognizer",
+    "UsHealthInsuranceMemberIdRecognizer",
     "UsMbiRecognizer",
     "UsNpiRecognizer",
     "UsPassportRecognizer",
+    "UsPrescriptionNumberRecognizer",
+    "UsPriorAuthorizationNumberRecognizer",
+    "UsProviderTaxIdRecognizer",
+    "UsReferralNumberRecognizer",
     "AbaRoutingRecognizer",
     "UsSsnRecognizer",
 ]

presidio-analyzer/presidio_analyzer/predefined_recognizers/country_specific/us/us_health_insurance_member_id_recognizer.py

@@ -0,0 +1,75 @@
+"""Recognizer for US health insurance member identifiers."""
+
+from typing import Dict, List, Optional
+
+from presidio_analyzer import Pattern, PatternRecognizer
+
+
+class UsHealthInsuranceMemberIdRecognizer(PatternRecognizer):
+    """Recognize US health insurance member/subscriber IDs with context.
+
+    US health insurance member identifiers are payer-specific and do not have a
+    single universal checksum or format. To avoid broad matching of generic
+    alphanumeric IDs, this recognizer requires both:
+    - a plausible alphanumeric member ID pattern, and
+    - nearby healthcare/insurance context.
+
+    CMS consumer guidance explicitly labels the payer-assigned member number on
+    a sample insurance card. Medicaid T-MSIS defines MEMBER-ID as the value shown
+    on the insurance carrier's card and permits up to 20 characters. These
+    sources establish the identifier and upper bound, not a universal syntax;
+    the default regex is therefore a conservative, replaceable heuristic.
+    Presidio applies ``re.IGNORECASE`` through its default global regex flags,
+    so the uppercase character classes also match lowercase and mixed-case IDs.
+
+    CMS card reference: https://www.cms.gov/files/document/11818-sample-insurance-card-english.pdf
+    Medicaid data reference: https://www.medicaid.gov/tmsis/dataguide/v4/data-elements/tpl003036/
+
+    :param patterns: List of patterns to be used by this recognizer
+    :param context: List of context words which increase detection confidence
+    :param supported_language: Language this recognizer supports
+    :param supported_entity: The entity this recognizer can detect
+    :param score_thresholds: Optional default and entity-specific score thresholds
+    """
+
+    COUNTRY_CODE = "us"
+
+    PATTERNS = [
+        Pattern(
+            "Health insurance member ID (weak)",
+            r"\b(?=[A-Z0-9-]{6,20}\b)(?=[A-Z0-9-]*[A-Z])"
+            r"(?=[A-Z0-9-]*\d)[A-Z]{1,5}-?[A-Z0-9]{5,14}\b",
+            0.1,
+        ),
+    ]
+
+    CONTEXT = [
+        "member",
+        "subscriber",
+        "insurance",
+        "policy",
+    ]
+
+    def __init__(
+        self,
+        patterns: Optional[List[Pattern]] = None,
+        context: Optional[List[str]] = None,
+        supported_language: str = "en",
+        supported_entity: str = "US_HEALTH_INSURANCE_MEMBER_ID",
+        name: Optional[str] = None,
+        score_thresholds: Optional[Dict[str, float]] = None,
+    ):
+        patterns = patterns if patterns else self.PATTERNS
+        context = context if context else self.CONTEXT
+        super().__init__(
+            supported_entity=supported_entity,
+            patterns=patterns,
+            context=context,
+            supported_language=supported_language,
+            name=name,
+        )
+        self.score_thresholds = (
+            score_thresholds
+            if score_thresholds is not None
+            else {supported_entity: 0.4}
+        )