Locations

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

Filename format

locations_##.json

JSON schema

JSON schema for Locations file

{
    "$schema": "https://json-schema.org/draft/2019-09/schema",
    "$id": "https://defacto.health/insurances/locations.schema.json",
    "title": "Healthcare locations",
    "description": "A collection of locations where healthcare services are provided.",
    "type": "object",
    "properties":
    {
        "locations":
        {
            "type": "array",
            "description": "All of the healthcare locations that Defacto Health has information for.",
            "items":
            {
                "type": "object",
                "properties":
                {
                    "locationId":
                    {
                        "type": "integer",
                        "description": "Defacto Health generated identifier for the location, unique across all locations."
                    },
                    "addressLine":
                    {
                        "type": "string",
                        "description": "First line component of the address.  This may be simply a street and street number, may include a suite or floor, or in some cases a department or descriptive location on a hospital campus. ",
                        "maxLength": 100
                    },
                    "city":
                    {
                        "type": "string",
                        "description": "City component of the location address",
                        "maxLength": 75
                    },
                    "state":
                    {
                        "type": "string",
                        "description": "Two-character state abbreviation of the location address.",
                        "maxLength": 2
                    },
                    "zipcode":
                    {
                        "type": "string",
                        "description": "Five or nine-digit zipcode.  No separators if nine-digit.",
                        "maxLength": 9
                    },
                    "phoneNumbers":
                    {
                        "type": ["array", "null"],
                        "description": "Array of phone numbers for the location; phone numbers are digits only, with no formatting or spaces."
                    }
                },
                "required":
                [
                    "locationId",
                    "addressLine",
                    "city",
                    "state",
                    "zipcode"
                ]
            }
        }
    }
}

Sample JSON

Sample JSON for Locations file

{
    "locations":
    [
        {
            "locationId": 58,
            "addressLine": "120 E 36th St Ste 1E",
            "city": "New York",
            "state": "NY",
            "zipcode": "10016",
            "phoneNumbers":
            [
                "2126852058"
            ]
        },
        {
            "locationId": 1784,
            "addressLine": "520 W Lincoln Ave Ste A",
            "city": "Ada",
            "state": "OH",
            "zipcode": "48510"
        }
    ]
}

Attributes

Attribute	Type	Description	Required	Constraints	Example
locationId	integer	Defacto Health generated identifier for the location, unique across all locations.	yes	> 0	58
addressLine	string	First line component of the address. This may be simply a street and street number, may include a suite or floor, or in some cases a department or descriptive location on a hospital campus.	yes	maxLength: 100	120 E 36th St Ste 1E
city	string	City component of the address.	yes	maxLength: 75	New York
state	string	Two-character state abbreviation of the location address.	yes	maxLength: 2	NY
zipcode	string	Five or nine-digit zipcode. No separators if nine-digit.	yes	maxLength: 9	10016
phoneNumbers	array[string]	Array of phone numbers for the location; phone numbers are digits only, with no formatting or spaces.	no		["2126852058"]