Health System provider for Faker

faker_healthcare_system is a provider for the Faker Python package.

Description

faker_healthcare_system provides fake data related to healthcare system for testing purposes.

Installation

Install with pip:

pip install faker-healthcare-system

Add as a provider to your Faker instance:

from faker import Faker
from provider_individual import IndividualProvider

fake = Faker()
fake.add_provider(IndividualProvider)

NPI

>>> fake.npi()
513653999

TIN

>>> fake.tin()
156224985

Gender

>>> fake.gender()
M

Enumeration date

>>> fake.enumeration_date()
2019-04-25

Taxonomy

>>> fake.taxonomy()
{
    'code': '2279H0200X', 
    'classification': 'Respiratory Therapist, Registered', 
    'specialization': 'Home Health', 
    'section': 'Individual', 
    'grouping': 'Respiratory, Developmental, Rehabilitative and Restorative Service Providers', 
    'display_name': 'Home Health Registered Respiratory Therapist'
}

Taxonomies of individuals

Generate the number of taxonomies specified.

Standard version 23.1, 7/1/23, created by NUCC, is being used.

>>> fake.fake.individual_taxonomies(2)
[
        {
            'code': '163WX0200X',
            'classification': 'Registered Nurse',
            'specialization': 'Oncology',
            'section': 'Individual',
            'grouping': 'Nursing Service Providers', 'display_name': 'Oncology Registered Nurse'
        },
        {
            'code': '202K00000X',
            'classification': 'Phlebology',
            'specialization': '',
            'section': 'Individual',
            'grouping': 'Allopathic & Osteopathic Physicians', 
            'display_name': 'Phlebology Physician'
        }
]

Unique Taxonomies of individuals

Generate the number of taxonomies specified.

>>> fake.individual_unique_taxonomies(2)
[
    {
        'code': '207RH0002X',
        'classification': 'Internal Medicine',
        'specialization': 'Hospice and Palliative Medicine',
        'section': 'Individual', 
        'grouping': 'Allopathic & Osteopathic Physicians',
        'display_name': 'Hospice and Palliative Medicine (Internal Medicine) Physician'
    },
    {
        'code': '246ZB0301X', 
        'classification': 'Specialist/Technologist, Other',
        'specialization': 'Biomedical Engineering',
        'section': 'Individual', 
        'grouping': 'Technologists, Technicians & Other Technical Service Providers',
        'display_name': 'Biomedical Engineer'
    }
]

Married name

>> female_person = fake.person_name_by_gender('F')
{
    'first_name': 'Amy', 
    'last_name': 'Miller', 
    'name_prefix': 'Mrs.', 
    'name_suffix': 'MD', 
    'type_name': 'Personal Name'
}
>> fake.person_married_name(female_person)
{
    'first_name': 'Amy',
    'last_name': 'Santana', 
    'name_prefix': 'Mrs.', 
    'name_suffix': 'MD', 
    'type_name': 'Married'
}

Address

Generate a random address; by default, the purpose is 'Mailing', but if you need to change it, put the desired purpose in the function.

>> female_person = fake.address_with_purpose()
{
    'country_code': 'US', 
    'country_name': 'United States', 
    'purpose': 'Mailing', 
    'address_type': 'FGN', 
    'address_1': '4106 Peterson Center\nEast Matthew, MA 92472', 
    'address_2': '1961 Leslie Mission\nNorth Christopherberg, DC 03284', 
    'city': 'Rhondashire', 
    'state': 'Nevada', 
    'postal_code': '63012', 
    'telephone_number': '270-845-8739x895', 
    'fax_number': '001-686-489-7865x80217'
}

>> female_person = fake.address_with_purpose('Main Office')
{
    'country_code': 'US', 
    'country_name': 'United States', 
    'purpose': 'Main Office', 
    'address_type': 'Physical', 
    'address_1': '4106 Peterson Center\nEast Matthew, MA 92472', 
    'address_2': '1961 Leslie Mission\nNorth Christopherberg, DC 03284', 
    'city': 'Rhondashire', 
    'state': 'Nuevo Hampshire', 
    'postal_code': '63012', 
    'telephone_number': '270-845-8739x895', 
    'fax_number': '001-686-489-7865x80217'
}

DEA

>> fake.dea()
{
    'number': 'M5490877',
    'allow_prescribe': True, 
    'start_date': datetime.date(2020, 3, 22), 
    'expiration_date': datetime.date(2024, 3, 21), 
    'supervising_number': 'Y5472030', 
    'supervising_license': 2806910
}

Professional degree school

>> fake.professional_degree_school()
Johns Hopkins University - Johns Hopkins School of Medicine

Language

>> fake.practitioner_language()
{
    'code': 'TR', 
    'description': 'Turkish', 
    'language_type': 'Practitioner'
}

Languages

Generates the specified number of languages, plus English

>> fake.practitioner_languages_plus_english(2)
[
    {
        'code': 'SM', 
        'description': 'Samoan', 
        'language_type': 'Practitioner'
    },
    {
        'code': 'FI', 
        'description': 'Finnish', 
        'language_type': 'Practitioner'
    }, 
    {
        'code': 'en', 
        'description': 'English', 
        'language_type': 'Practitioner'
    }
]

Ethnicity

>> fake.practitioner_ethnicity_code()
{   
    'code': 'J', 
    'description': 'JAPANESE'
}

Gender restriccion

>> fake.gender_restriction()
F

Malpractice

>> fake.malpractice()
{
    'insurance': 'Fairway Physicians Ins. Co.', 
    'insurance_policy_number': 5, 
    'covered_amount': ' 1-6'
}

License

>> fake.license()
{
    'license': 'I93615979', 
    'state': 'Dakota del Sur', 
    'is_primary': False, 
    'start_date': datetime.date(2020, 3, 22), 
    'end_date': datetime.date(2024, 3, 21)
}

Identifier

>> fake.identifier()
{
    'code': 6950, 
    'desc': 'Medicare', 
    'issuer': 'pZGG', 
    'identifier': '59333', 
    'state': 'Misuri'
}

Board

>> fake.board()
{
    'status': 2, 
    'start_date': datetime.date(2022, 1, 31), 
    'expiration_date': datetime.date(2023, 1, 31)
}

Working hours

>> fake.working_hours()
10:00-13:00

Weekly working hours

>> fake.weekly_working_hours()
{
    'Monday': '10:00-13:00', 
    'Tuesday': '7:00-13:00', 
    'Wednesday': '10:00-20:00', 
    'Thursday': '9:00-17:00', 
    'Friday': '8:00-18:00', 
    'Saturday': 'CLOSED', 
    'Sunday': 'CLOSED'
}

Taxonomy qualification

>> fake.taxonomy_qualification()
{
    'board': {
                'status': 5, 
                'start_date': datetime.date(2023, 8, 18), 
                'expiration_date': datetime.date(2024, 8, 17)
             }, 
    'intership_start_date': datetime.date(2021, 10, 16), 
    'intership_expiration_date': datetime.date(2024, 10, 15), 
    'residency_start_date': datetime.date(2021, 10, 16), 
    'residency_expiration_date': datetime.date(2023, 10, 16), 
    'fellowship_start_date': datetime.date(2021, 10, 16), 
    'fellowship_expiration_date': datetime.date(2024, 10, 15), 
    'taxonomy': 
                {
                    'code': '103T00000X', 
                    'classification': 'Psychologist', 
                    'specialization': '', 
                    'section': 'Individual', 
                    'grouping': 'Behavioral Health & Social Service Providers', 
                    'display_name': 'Psychologist'
                }, 
    'facility_type': 10
}

Endpoint

>> fake.endpoint()
{
    'endpointType': 'CONNECT', 
    'endpointTypeDescription': 'CONNECT URL', 
    'endpoint': 'http://thompson-young.com/blog/appregister.htm', 
    'endpointDescription': '', 
    'affiliation': 'N', 
    'use': 'DIRECT', 
    'useDescription': 'Direct', 
    'contentType': 'OTHER', 
    'contentTypeDescription': 'Communication', 
    'contentOtherDescription': 'Communication', 
    'country_code': 'US', 
    'country_name': 'United States', 
    'address_1': '628 Banks Stravenue\nCarolynfort, DC 08813', 
    'city': 'Kylemouth', 
    'state': 'Vermont', 
    'postal_code': '71465'
}

Individual

>> fake.individual_object()
{
    'npi': 465929309,
    'tin': 155728978, 
    'last_updated_epoch': datetime.date(2022, 5, 23), 
    'created_epoch': datetime.date(2019, 5, 24), 
    'enumeration_date': datetime.date(2020, 3, 24), 
    'status': 'Active', 
    'email': 'matthewcook@example.org', 
    'enumeration_type': 'NPI-1', 
    'mailing_address': {
                            'country_code': 'US', 
                            'country_name': 'United States', 
                            'purpose': 'Mailing', 
                            'address_type': 'DOM', 
                            'address_1': '96105 Garcia Cape Apt. 220\nRhondashire, NJ 35277', 
                            'address_2': '5873 Smith Trafficway\nCohenfort, NC 88118', 
                            'city': 'Brookston', 
                            'state': 'Ohio', 
                            'postal_code': '99351', 
                            'telephone_number': '+1-721-274-2558x6176', 
                            'fax_number': '291.650.5368'
                        }, 
    'location_address': {
                            'country_code': 'US', 
                            'country_name': 'United States', 
                            'purpose': 'LOCATION', 
                            'address_type': 'FGN', 
                            'address_1': 'Unit 3872 Box 2876\nDPO AA 06285', 
                            'address_2': '04546 Smith River Apt. 851\nSouth Priscillaside, MS 10132', 
                            'city': 'Johnsonmouth', 
                            'state': 'Alaska', 
                            'postal_code': '34912', 
                            'telephone_number': '308.256.5026x1253', 
                            'fax_number': '001-486-884-2465x28581'
                         }, 
    'main_office_address': {
                                'country_code': 'US', 
                                'country_name': 'United States', 
                                'purpose': 'Main Office', 
                                'address_type': 'Physical', 
                                'address_1': '0577 Patterson Trail\nEast Aimeehaven, NY 73452', 
                                'address_2': '539 Davis Parkways\nEast Olivia, KS 52689', 
                                'city': 'New Christopherborough', 
                                'state': 'Maine', 
                                'postal_code': '66709', 
                                'telephone_number': '303.749.3195', 
                                'fax_number': '+1-682-982-7760'
                            }, 
    'taxonomies': [
                    {
                        'code': '2084E0001X', 
                        'classification': 'Psychiatry & Neurology', 
                        'specialization': 'Epilepsy', 
                        'section': 'Individual', 
                        'grouping': 'Allopathic & Osteopathic Physicians', 
                        'display_name': 'Epilepsy Physician'
                    }, 
                    {
                        'code': '146L00000X', 
                        'classification': 'Emergency Medical Technician, Paramedic', 
                        'specialization': '', 
                        'section': 'Individual', 
                        'grouping': 'Emergency Medical Service Providers', 
                        'display_name': 'Paramedic'
                    }, 
                    {
                        'code': '163WX0003X', 
                        'classification': 'Registered Nurse', 
                        'specialization': 'Obstetric, Inpatient', 
                        'section': 'Individual', 
                        'grouping': 'Nursing Service Providers', 
                        'display_name': 'Inpatient Obstetric Registered Nurse'
                    }, 
                    {
                        'code': '364SP0812X', 
                        'classification': 'Clinical Nurse Specialist', 
                        'specialization': 'Psychiatric/Mental Health, Community', 
                        'section': 'Individual', 
                        'grouping': 'Physician Assistants & Advanced Practice Nursing Providers', 
                        'display_name': 'Community Psychiatric/Mental Health Clinical Nurse Specialist'
                    }
                 ], 
    'licenses': [
                    {
                        'license': 'M981935046', 
                        'state': 'Alaska', 
                        'is_primary': True, 
                        'start_date': datetime.date(2021, 6, 12), 
                        'end_date': datetime.date(2023, 6, 12)
                    }, 
                    {
                        'license': 'U6400179',
                        'state': 'Utah', 
                        'is_primary': False, 
                        'start_date': datetime.date(2022, 8, 5), 
                        'end_date': datetime.date(2026, 8, 4)
                    }, 
                    {   
                        'license': 'W627735057', 
                        'state': 'Maine', 
                        'is_primary': True, 
                        'start_date': datetime.date(2021, 6, 17), 
                        'end_date': datetime.date(2022, 6, 17)
                    }, 
                    {
                        'license': 'O388523895', 
                        'state': 'Wisconsin', 
                        'is_primary': False, 
                        'start_date': datetime.date(2021, 7, 14), 
                        'end_date': datetime.date(2025, 7, 13)
                    }
                 ], 
    'identifiers': '',
    'taxonomy_qualification': '',
    'taxonomy_endpoints': '', 
    'schedule': '',
    'credential': 'MD', 
    'sole_proprietor': 'NO', 
    'gender': 'F', 
    'personal_name': {
                        'first_name': 'Deborah',
                        'last_name': 'Roberson', 
                        'name_prefix': 'Dr.', 
                        'name_suffix': 'MD', 
                        'type_name': 'Personal Name'
                     }, 
    'other_names': {
                        'first_name': 'Deborah', 
                        'last_name': 'Stewart', 
                        'name_prefix': 'Dr.', 
                        'name_suffix': 'MD', 
                        'type_name': 'Married'
                    }, 
    'dea': {
                'number': 'C8533755',
                'allow_prescribe': True, 
                'start_date': datetime.date(2020, 12, 2), 
                'expiration_date': datetime.date(2022, 12, 2), 
                'supervising_number': 'Y4031241', 
                'supervising_license': 7415179
            }, 
    'ethnicity_code': 'T', 
    'date_of_birth': datetime.date(2017, 7, 30), 
    'languages': [
                    {'code': 'BG', 'description': 'Bulgarian', 'language_type': 'Practitioner'},
                    {'code': 'RU', 'description': 'Russian', 'language_type': 'Practitioner'}, 
                    {'code': 'CO', 'description': 'Corsican', 'language_type': 'Practitioner'}, 
                    {'code': 'BR', 'description': 'Breton', 'language_type': 'Practitioner'}, 
                    {'code': 'SL', 'description': 'Slovene', 'language_type': 'Practitioner'}, 
                    {'code': 'MG', 'description': 'Malagasy', 'language_type': 'Practitioner'}, 
                    {'code': 'en', 'description': 'English', 'language_type': 'Practitioner'}], 
    'gender_restriction': 'F', 
    'malpractice': {
                        insurance': 'MUTUAL PROTECTION TRUST', 
                        'insurance_policy_number': 7297077, 
                        'covered_amount': ' 8-4'
                    }, 
    'professional_degree_school': 'University of Washington - UW School of Medicine'
    }

Organizations

#### Generate an organization with the specified number of NPI, default is 1,

>> fake.organization_object(max_npi=3)
{
    'npi': [321598958, 928109630, 366741961], 
    'tin': 711175146, 
    'last_updated_epoch': datetime.date(2021, 1, 24), 
    'created_epoch': datetime.date(2019, 1, 25), 
    'enumeration_date': datetime.date(2020, 5, 6), 
    'status': 'Active', 
    'email': 'deborahwest@example.net', 
    'enumeration_type': 'NPI-2', 
    'mailing_address': {
                        'country_code': 'US', 
                        'country_name': 'United States', 
                        'purpose': 'Mailing', 
                        'address_type': 'MIL', 
                        'address_1': '2594 Dunn Radial\nWest Jennifermouth, NM 55692', 
                        'address_2': '78773 Powers Greens\nRosehaven, DC 42074', 
                        'city': 'New Chadtown', 
                        'state': 'Nebraska', 
                        'postal_code': '16089', 
                        'telephone_number': '306-999-1768x365', 
                        'fax_number': '483.589.1410x715'
                        }, 
    'location_address': {
                        'country_code': 'US', 
                        'country_name': 'United States', 
                        'purpose': 'LOCATION', 
                        'address_type': 'DOM', 
                        'address_1': '305 Michelle Key Apt. 304\nWest Kellyberg, CT 16549', 
                        'address_2': '1063 Smith Lake Apt. 999\nNixonberg, WA 28039', 
                        'city': 'Port Timothy', 
                        'state': 'Maryland', 
                        'postal_code': '21290', 
                        'telephone_number': '807.472.1198x8935', 
                        'fax_number': '001-935-380-7717x264'
                        }, 
    'main_office_address': {
                            'country_code': 'US', 
                            'country_name': 'United States', 
                            'purpose': 'Main Office', 
                            'address_type': 'Physical', 
                            'address_1': '981 John Road\nRobertmouth, FL 10531', 
                            'address_2': '13237 Karen Village Apt. 024\nPort Beverlytown, ME 46029', 
                            'city': 'Benjamintown', 
                            'state': 'Luisiana', 
                            'postal_code': '16387', 
                            'telephone_number': '623-739-8700x2088', 
                            'fax_number': '545.882.9199'
                            }, 
    'taxonomies': [
                    {
                        'code': '1835N1003X', 
                        'classification': 'Pharmacist', 
                        'specialization': 'Nutrition Support', 
                        'section': 'Individual', 
                        'grouping': 
                        'Pharmacy Service Providers', 
                        'display_name': 'Nutrition Support Pharmacist'
                    }, 
                    {
                        'code': '208G00000X', 
                        'classification': 'Thoracic Surgery (Cardiothoracic Vascular Surgery)', 
                        'specialization': '', 
                        'section': 'Individual', 
                        'grouping': 'Allopathic & Osteopathic Physicians', 
                        'display_name': 'Thoracic Surgery (Cardiothoracic Vascular Surgery) Physician'
                    }, 
                    {
                        'code': '364SI0800X', 
                        'classification': 'Clinical Nurse Specialist', 
                        'specialization': 'Informatics', 
                        'section': 'Individual', 
                        'grouping': 'Physician Assistants & Advanced Practice Nursing Providers', 
                        'display_name': 'Informatics Clinical Nurse Specialist'
                    }, 
                    {
                        'code': '364SW0102X', 
                        'classification': 'Clinical Nurse Specialist', 
                        'specialization': "Women's Health", 
                        'section': 'Individual', 
                        'grouping': 'Physician Assistants & Advanced Practice Nursing Providers', 
                        'display_name': "Women's Health Clinical Nurse Specialist"
                    }
                 ], 
    'licenses': 
                [
                    {
                        'license': 'Z188552678', 
                        'state': 'Pensilvania', 
                        'is_primary': True, 
                        'start_date': datetime.date(2020, 12, 11), 
                        'end_date': datetime.date(2024, 12, 10)
                    }, 
                    {
                        'license': 'M184632866', 
                        'state': 'Nuevo México', 
                        'is_primary': True, 
                        'start_date': datetime.date(2023, 5, 8), 
                        'end_date': datetime.date(2026, 5, 7)
                    }, 
                    {
                        'license': 'U460102758', 
                        'state': 'Kansas', 
                        'is_primary': True, 
                        'start_date': datetime.date(2023, 2, 26), 
                        'end_date': datetime.date(2024, 2, 26)
                    }, 
                    {
                        'license': 'D68435211', 
                        'state': 'Oregón', 
                        'is_primary': True, 
                        'start_date': datetime.date(2020, 9, 18), 
                        'end_date': datetime.date(2022, 9, 18)
                    }, 
                    {
                        'license': 'D918869194', 
                        'state': 'Delaware', 
                        'is_primary': False, 
                        'start_date': datetime.date(2022, 9, 15), 
                        'end_date': datetime.date(2026, 9, 14)
                    }, 
                    {
                        'license': 'C10973103', 
                        'state': 'Arizona', 
                        'is_primary': False, 
                        'start_date': datetime.date(2022, 12, 18), 
                        'end_date': datetime.date(2026, 12, 17)
                    }, 
                    {
                        'license': 'P188687644', 
                        'state': 'Washington', 
                        'is_primary': True, 
                        'start_date': datetime.date(2021, 4, 27), 
                        'end_date': datetime.date(2023, 4, 27)
                    }, 
                    {
                        'license': 'Z755492445', 
                        'state': 'Colorado', 
                        'is_primary': True, 
                        'start_date': datetime.date(2022, 3, 12), 
                        'end_date': datetime.date(2026, 3, 11)
                    }, 
                    {
                        'license': 'R671526523', 
                        'state': 'Nebraska', 
                        'is_primary': True, 
                        'start_date': datetime.date(2020, 8, 9), 
                        'end_date': datetime.date(2022, 8, 9)
                    }
                ], 
    'identifiers': {
                    'code': 5691, 
                    'desc': 'Medicare', 
                    'issuer': 'TWsd', 
                    'identifier': '56720', 
                    state': 'Misuri'
                    }, 
    'credential': 'DMD', 
    'sole_proprietor': 'NO', 
    'gender': 'F', 
    'personal_name': 
                    {
                        'first_name': 'Sara', 
                        'last_name': 'Pratt', 
                        'name_prefix': 'Mrs.', 
                        'name_suffix': 'DDS', 
                        'type_name': 'Personal Name'
                    }, 
    'other_names': '', 
    'dea': 
            {
            'number': 'A8778730', 
            'allow_prescribe': False, 
            'start_date': datetime.date(2023, 9, 4), 
            'expiration_date': datetime.date(2026, 9, 3), 
            'supervising_number': 'Y6652962', 
            'supervising_license': 9123515
            }, 
    'ethnicity_code': '', 
    'date_of_birth': '', 
    'languages': [
                    {
                        'code': 'KO', 
                        'description': 'Korean', 
                        'language_type': 'Practitioner'}, {'code': 'CS', 'description': 'Czech', 'language_type': 'Practitioner'}, {'code': 'KW', 'description': 'Cornish', 'language_type': 'Practitioner'}, {'code': 'GA', 'description': 'Irish', 'language_type': 'Practitioner'}, {'code': 'CV', 'description': 'Chuvash', 'language_type': 'Practitioner'}, {'code': 'AR', 'description': 'Arabic', 'language_type': 'Practitioner'}, {'code': 'en', 'description': 'English', 'language_type': 'Practitioner'}], 'gender_restriction': '', 'malpractice': {'insurance': 'NORCAL Mutual Insurance Company', 'insurance_policy_number': 164, 'covered_amount': ' 4-4'}, 'professional_degree_school': '', 'organization_name': 'Rivera-Meyer', 'organization_subpart': 'YES', 'organization_type': 'Official', 'person_authorized': 'Ashley Rios', 'person_authorized_title_or_position': 'EXECUTIVE DIRECTOR', 'other_organization_name_1': 'Robertson, Boyd and Hall', 'other_organization_subpart_1': 'NO', 'other_organization_type_1': 'Official', 'other_organization_name_2': 'Gibson-Gentry', 'other_organization_subpart_2': 'YES', 'other_organization_type_2': 'Official', 'pcmh_status': 3}