Skip to content

Organizations

The Organizations file contains information about organizational healthcare providers (provider groups, health systems) for whom Defacto Health has insurances accepted information.

Filename format

organizations_##.json

JSON schema

JSON schema for Organizations file
{
    "$schema": "https://json-schema.org/draft/2019-09/schema",
    "$id": "https://defacto.health/insurances/organizations.schema.json",
    "title": "Healthcare organizations",
    "description": "A collection of healthcare organizations that Defacto Health has information for.",
    "type": "object",
    "properties":
    {
        "organizations":
        {
            "type": "array",
            "description": "All of the organizations that Defacto Health has information for.",
            "items":
            {
                "type": "object",
                "properties":
                {
                    "organizationId":
                    {
                        "type": "integer",
                        "description": "Defacto Health generated identifier for the carrier, unique across all organizations."
                    },
                    "npi":
                    {
                        "type": "integer",
                        "description": "National Provider Identifier for the organization; identifier assigned by CMS.  NPIs are reported as received from the carriers and are not validated against NPPES.",
                        "maximum": 9999999999
                    },
                    "name":
                    {
                        "type": "string",
                        "description": "Name of the organization.",
                        "maxLength": 100
                    },
                    {
                "type": "string",
                "description": "Organization type code that indicates the type of healthcare organization.",
                "maxLength": 100
                    }
                },
                "required": ["organizationId", "npi"]
            }
        }
    }
}

Sample JSON

Sample JSON for Organizations file
{
    "organizations":
    [
        {
            "organizationId": 1,
            "npi": 1234567890,
            "name": "Smith Internal Medicine",
            "type": "prvgrp",

        },
        {
            "organizationId": 2,
            "npi": 2345678901,
            "name": "City General Hospital",
            "type": "fac",
        }
    ]
}

Attributes

Attribute Type Description Required Constraints Example
organizationId integer Defacto Health generated identifier for the carrier, unique across all organizations. 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
name string Name of the organization no maxLength: 100 Public
type string Organization type code that indicates the type of healthcare organization. no maxLength: 100 "prvgrp"