Practitioners

The Practitioners file contains information about individual healthcare providers (physicians, mid-level practitioners) for whom Defacto Health has insurances accepted information.

Filename format

practitioners_##.json

JSON schema

JSON schema for Practitioners file

{
    "$schema": "https://json-schema.org/draft/2019-09/schema",
    "$id": "https://defacto.health/insurances/practitioners.schema.json",
    "title": "Healthcare practitioners",
    "description": "A collection of healthcare practitioners that Defacto Health has information for.",
    "type": "object",
    "properties":
    {
        "practitioners":
        {
            "type": "array",
            "description": "All of the practitioners that Defacto Health has information for.",
            "items":
            {
                "type": "object",
                "properties":
                {
                    "practitionerId":
                    {
                        "type": "integer",
                        "description": "Defacto Health generated identifier for the carrier, unique across all practitioners."
                    },
                    "npi":
                    {
                        "type": "integer",
                        "description": "National Practitioner Identifier for the practitioner; identifier assigned by CMS.  NPIs are reported as received from the carriers and are not validated against NPPES.",
                        "maximum": 9999999999
                    },
                    "lastName":
                    {
                        "type": "string",
                        "description": "Last name of the practitioner.",
                        "maxLength": 100
                    },
                    "givenNames":
                    {
                        "type": "string",
                        "description": "Given name(s) of the practitioner, separated by spaces.",
                        "maxLength": 100
                    },
                    "gender":
                    {
                        "type": "string",
                        "description": "Gender of the practitioner."
                    },
                    "specialties":
                    {
                        "type": ["array", "null"],
                        "description": "Array of NUCC taxonomy codes representing pracittioner specialties."
                    },
                    "languages":
                    {
                        "type": ["array", "null"],
                        "description": "Array of languages spoken by the practitioner."
                    }
                },
                "required": ["practitionerId", "npi"]
            }
        }
    }
}

Sample JSON

Sample JSON for Practitioners file

{
    "practitioners":
    [
        {
            "practitionerId": 1,
            "npi": 1234567890,
            "lastName": "Public",
            "givenNames": "John Q",
            "gender": "male",
            "specialties":
            [
                "207Q00000X",
                "207QG0300X"
            ],
            "languages":
            [
                "English",
                "Spanish"
            ]
        },
        {
            "practitionerId": 2,
            "npi": 2345678901,
            "lastName": "Doe",
            "givenNames": "Jane",
            "gender": "female",
            "specialties":
            [
                "208000000X"
            ]
        }
    ]
}

Attributes

Attribute	Type	Description	Required	Constraints	Example
practitionerId	integer	Defacto Health generated identifier for the carrier, unique across all practitioners. This identifier is persistent across data deliveries.	yes	> 0	25
npi	integer	National Practitioner Identifier for the practitioner; identifier assigned by CMS. NPIs are reported as received from the carriers and are not validated against NPPES.	yes	maximum: 9999999999	1234567890
lastName	string	Last name of the practitioner.	no	maxLength: 100	Public
givenNames	string	Given name(s) of the practitioner, separated by spaces.	no	maxLength: 100	John Q
gender	string	Gender of the practitioner.	no		female
specialties	array[string]	Array of NUCC taxonomy codes representing the practitioner's specialties.	no	Must be valid taxonomy codes	["207Q00000X", "207QG0300X"]
languages	array[string]	Array of languages spoken by the practitioner.	no		["English", "Spanish"]