Organization

A formally or informally recognized grouping of people or organizations formed for the purpose of achieving some form of collective action. Includes companies, institutions, corporations, departments, community groups, healthcare practice groups, payer/insurer, etc.

Columns

Header row
# path type required description
0 resourceType string * Resource type identifier. Must be string "Organization"
1 integer * Number of subrows
2 id string * Logical id of this artifact
3 active boolean Whether the organization's record is still in active use
4 name string Name used for the organization
partOf Reference The organization of which this organization forms a part
5 partOf.reference string Literal reference, Relative, internal or absolute URL
6 partOf.type uri Type the reference refers to (e.g. "Patient")
partOf.identifier Identifier Logical reference, when literal reference is not known
7 partOf.identifier.use code usual | official | temp | secondary | old (If known)
partOf.identifier.type CodeableConcept Description of identifier
partOf.identifier.type.coding Coding Code defined by a terminology system
8 partOf.identifier.type.coding.system uri Identity of the terminology system
9 partOf.identifier.type.coding.version string Version of the system - if relevant
10 partOf.identifier.type.coding.code code Symbol in syntax defined by the system
11 partOf.identifier.type.coding.display string Representation defined by the system
12 partOf.identifier.type.coding.userSelected boolean If this coding was chosen directly by the user
13 partOf.identifier.type.text string Plain text representation of the concept
14 partOf.identifier.system uri The namespace for the identifier value
15 partOf.identifier.value string The value that is unique
partOf.identifier.period Period Time period when id is/was valid for use
16 partOf.identifier.period.start dateTime Starting time with inclusive boundary
17 partOf.identifier.period.end dateTime End time with inclusive boundary, if not ongoing
18 partOf.display string Text alternative for the resource
Row identifier
# path type required description
0 string * Subrow identifier. Must be string "identifier"
identifier Identifier Identifies this organization across multiple systems
1 identifier.use code usual | official | temp | secondary | old (If known)
identifier.type CodeableConcept Description of identifier
identifier.type.coding Coding Code defined by a terminology system
2 identifier.type.coding.system uri Identity of the terminology system
3 identifier.type.coding.version string Version of the system - if relevant
4 identifier.type.coding.code code Symbol in syntax defined by the system
5 identifier.type.coding.display string Representation defined by the system
6 identifier.type.coding.userSelected boolean If this coding was chosen directly by the user
7 identifier.type.text string Plain text representation of the concept
8 identifier.system uri The namespace for the identifier value
9 identifier.value string The value that is unique
identifier.period Period Time period when id is/was valid for use
10 identifier.period.start dateTime Starting time with inclusive boundary
11 identifier.period.end dateTime End time with inclusive boundary, if not ongoing
Row type
# path type required description
0 string * Subrow identifier. Must be string "type"
type CodeableConcept Kind of organization
type.coding Coding Code defined by a terminology system
1 type.coding.system uri Identity of the terminology system
2 type.coding.version string Version of the system - if relevant
3 type.coding.code code Symbol in syntax defined by the system
4 type.coding.display string Representation defined by the system
5 type.coding.userSelected boolean If this coding was chosen directly by the user
6 type.text string Plain text representation of the concept
Row alias
# path type required description
0 string * Subrow identifier. Must be string "alias"
1 alias string A list of alternate names that the organization is known as, or was known as in the past
Row telecom
# path type required description
0 string * Subrow identifier. Must be string "telecom"
telecom ContactPoint A contact detail for the organization
1 telecom.system code phone | fax | email | pager | url | sms | other
2 telecom.value string The actual contact point details
3 telecom.use code home | work | temp | old | mobile - purpose of this contact point
4 telecom.rank positiveInt Specify preferred order of use (1 = highest)
telecom.period Period Time period when the contact point was/is in use
5 telecom.period.start dateTime Starting time with inclusive boundary
6 telecom.period.end dateTime End time with inclusive boundary, if not ongoing
Row address
# path type required description
0 string * Subrow identifier. Must be string "address"
address Address An address for the organization
1 address.use code home | work | temp | old | billing - purpose of this address
2 address.type code postal | physical | both
3 address.text string Text representation of the address
4 address.line string Street name, number, direction & P.O. Box etc.
5 address.city string Name of city, town etc.
6 address.district string District name (aka county)
7 address.state string Sub-unit of country (abbreviations ok)
8 address.postalCode string Postal code for area
9 address.country string Country (e.g. can be ISO 3166 2 or 3 letter code)
address.period Period Time period when address was/is in use
10 address.period.start dateTime Starting time with inclusive boundary
11 address.period.end dateTime End time with inclusive boundary, if not ongoing
Row contact
# path type required description
0 string * Subrow identifier. Must be string "contact"
contact Contact for the organization for a certain purpose
contact.purpose CodeableConcept The type of contact
contact.purpose.coding Coding Code defined by a terminology system
1 contact.purpose.coding.system uri Identity of the terminology system
2 contact.purpose.coding.version string Version of the system - if relevant
3 contact.purpose.coding.code code Symbol in syntax defined by the system
4 contact.purpose.coding.display string Representation defined by the system
5 contact.purpose.coding.userSelected boolean If this coding was chosen directly by the user
6 contact.purpose.text string Plain text representation of the concept
contact.name HumanName A name associated with the contact
7 contact.name.use code usual | official | temp | nickname | anonymous | old | maiden
8 contact.name.text string Text representation of the full name
9 contact.name.family string Family name (often called 'Surname')
10 contact.name.given string Given names (not always 'first'). Includes middle names
11 contact.name.prefix string Parts that come before the name
12 contact.name.suffix string Parts that come after the name
contact.name.period Period Time period when name was/is in use
13 contact.name.period.start dateTime Starting time with inclusive boundary
14 contact.name.period.end dateTime End time with inclusive boundary, if not ongoing
contact.telecom ContactPoint Contact details (telephone, email, etc.) for a contact
15 contact.telecom.system code phone | fax | email | pager | url | sms | other
16 contact.telecom.value string The actual contact point details
17 contact.telecom.use code home | work | temp | old | mobile - purpose of this contact point
18 contact.telecom.rank positiveInt Specify preferred order of use (1 = highest)
contact.telecom.period Period Time period when the contact point was/is in use
19 contact.telecom.period.start dateTime Starting time with inclusive boundary
20 contact.telecom.period.end dateTime End time with inclusive boundary, if not ongoing
contact.address Address Visiting or postal addresses for the contact
21 contact.address.use code home | work | temp | old | billing - purpose of this address
22 contact.address.type code postal | physical | both
23 contact.address.text string Text representation of the address
24 contact.address.line string Street name, number, direction & P.O. Box etc.
25 contact.address.city string Name of city, town etc.
26 contact.address.district string District name (aka county)
27 contact.address.state string Sub-unit of country (abbreviations ok)
28 contact.address.postalCode string Postal code for area
29 contact.address.country string Country (e.g. can be ISO 3166 2 or 3 letter code)
contact.address.period Period Time period when address was/is in use
30 contact.address.period.start dateTime Starting time with inclusive boundary
31 contact.address.period.end dateTime End time with inclusive boundary, if not ongoing
Row endpoint
# path type required description
0 string * Subrow identifier. Must be string "endpoint"
endpoint Reference Technical endpoints providing access to services operated for the organization
1 endpoint.reference string Literal reference, Relative, internal or absolute URL
2 endpoint.type uri Type the reference refers to (e.g. "Patient")
endpoint.identifier Identifier Logical reference, when literal reference is not known
3 endpoint.identifier.use code usual | official | temp | secondary | old (If known)
endpoint.identifier.type CodeableConcept Description of identifier
endpoint.identifier.type.coding Coding Code defined by a terminology system
4 endpoint.identifier.type.coding.system uri Identity of the terminology system
5 endpoint.identifier.type.coding.version string Version of the system - if relevant
6 endpoint.identifier.type.coding.code code Symbol in syntax defined by the system
7 endpoint.identifier.type.coding.display string Representation defined by the system
8 endpoint.identifier.type.coding.userSelected boolean If this coding was chosen directly by the user
9 endpoint.identifier.type.text string Plain text representation of the concept
10 endpoint.identifier.system uri The namespace for the identifier value
11 endpoint.identifier.value string The value that is unique
endpoint.identifier.period Period Time period when id is/was valid for use
12 endpoint.identifier.period.start dateTime Starting time with inclusive boundary
13 endpoint.identifier.period.end dateTime End time with inclusive boundary, if not ongoing
14 endpoint.display string Text alternative for the resource

Examples

Example #1
Input CSV
Organization,8,"f001",,"Burgers University Medical Center",,,,,,,,,,,,,,
identifier,"official",,,,,,,"urn:oid:2.16.528.1","91654",,
identifier,"usual",,,,,,,"urn:oid:2.16.840.1.113883.2.4.6.1","17-0112278",,
type,"urn:oid:2.16.840.1.113883.2.4.15.1060",,"V6","University Medical Hospital",,
telecom,"phone","022-655 2300","work",,,
address,"work",,,"Galapagosweg 91","Den Burg",,,"9105 PZ","NLD",,
address,"work",,,"PO Box 2311","Den Burg",,,"9100 AA","NLD",,
contact,"http://terminology.hl7.org/CodeSystem/contactentity-type",,"PRESS",,,,,,,,,,,,"phone","022-655 2334",,,,,,,,,,,,,,,
contact,"http://terminology.hl7.org/CodeSystem/contactentity-type",,"PATINF",,,,,,,,,,,,"phone","022-655 2335",,,,,,,,,,,,,,,
Resulting resource
{
  "resourceType": "Organization",
  "id": "f001",
  "identifier": [
    {
      "use": "official",
      "system": "urn:oid:2.16.528.1",
      "value": "91654"
    },
    {
      "use": "usual",
      "system": "urn:oid:2.16.840.1.113883.2.4.6.1",
      "value": "17-0112278"
    }
  ],
  "type": [
    {
      "coding": [
        {
          "system": "urn:oid:2.16.840.1.113883.2.4.15.1060",
          "code": "V6",
          "display": "University Medical Hospital"
        },
        {
          "system": "http://terminology.hl7.org/CodeSystem/organization-type",
          "code": "prov",
          "display": "Healthcare Provider"
        }
      ]
    }
  ],
  "name": "Burgers University Medical Center",
  "telecom": [
    {
      "system": "phone",
      "value": "022-655 2300",
      "use": "work"
    }
  ],
  "address": [
    {
      "use": "work",
      "line": [
        "Galapagosweg 91"
      ],
      "city": "Den Burg",
      "postalCode": "9105 PZ",
      "country": "NLD"
    },
    {
      "use": "work",
      "line": [
        "PO Box 2311"
      ],
      "city": "Den Burg",
      "postalCode": "9100 AA",
      "country": "NLD"
    }
  ],
  "contact": [
    {
      "purpose": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/contactentity-type",
            "code": "PRESS"
          }
        ]
      },
      "telecom": [
        {
          "system": "phone",
          "value": "022-655 2334"
        }
      ]
    },
    {
      "purpose": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/contactentity-type",
            "code": "PATINF"
          }
        ]
      },
      "telecom": [
        {
          "system": "phone",
          "value": "022-655 2335"
        }
      ]
    }
  ]
}
Example #2
Input CSV
Organization,4,"f002",true,"Burgers UMC Cardiology unit","Organization/f001",,,,,,,,,,,,,
type,"http://terminology.hl7.org/CodeSystem/organization-type",,"dept","Hospital Department",,
telecom,"phone","022-655 2320",,,,
address,,,,"South Wing, floor 2",,,,,,,
contact,"http://terminology.hl7.org/CodeSystem/contactentity-type",,"ADMIN",,,,,"mevr. D. de Haan",,,,,,,"phone","022-655 2321",,,,,,,,"South Wing, floor 2",,,,,,,
Resulting resource
{
  "resourceType": "Organization",
  "id": "f002",
  "active": true,
  "type": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/organization-type",
          "code": "dept",
          "display": "Hospital Department"
        }
      ]
    }
  ],
  "name": "Burgers UMC Cardiology unit",
  "telecom": [
    {
      "system": "phone",
      "value": "022-655 2320"
    }
  ],
  "address": [
    {
      "line": [
        "South Wing, floor 2"
      ]
    }
  ],
  "partOf": {
    "reference": "Organization/f001"
  },
  "contact": [
    {
      "purpose": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/contactentity-type",
            "code": "ADMIN"
          }
        ]
      },
      "name": {
        "text": "mevr. D. de Haan"
      },
      "telecom": [
        {
          "system": "phone",
          "value": "022-655 2321"
        },
        {
          "system": "email",
          "value": "cardio@burgersumc.nl"
        },
        {
          "system": "fax",
          "value": "022-655 2322"
        }
      ],
      "address": {
        "line": [
          "South Wing, floor 2"
        ]
      }
    }
  ]
}
Example #3
Input CSV
Organization,4,"f003",true,"Burgers UMC Ear,Nose,Throat unit","Organization/f001",,,,,,,,,,,,,
type,"http://terminology.hl7.org/CodeSystem/organization-type",,"dept","Hospital Department",,
telecom,"phone","022-655 6780",,,,
address,,,,"West Wing, floor 5",,,,,,,
contact,"http://terminology.hl7.org/CodeSystem/contactentity-type",,"ADMIN",,,,,"mr. F. de Hond",,,,,,,"phone","022-655 7654",,,,,,,,"West Wing, floor 5",,,,,,,
Resulting resource
{
  "resourceType": "Organization",
  "id": "f003",
  "active": true,
  "type": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/organization-type",
          "code": "dept",
          "display": "Hospital Department"
        }
      ]
    }
  ],
  "name": "Burgers UMC Ear,Nose,Throat unit",
  "telecom": [
    {
      "system": "phone",
      "value": "022-655 6780"
    }
  ],
  "address": [
    {
      "line": [
        "West Wing, floor 5"
      ]
    }
  ],
  "partOf": {
    "reference": "Organization/f001"
  },
  "contact": [
    {
      "purpose": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/contactentity-type",
            "code": "ADMIN"
          }
        ]
      },
      "name": {
        "text": "mr. F. de Hond"
      },
      "telecom": [
        {
          "system": "phone",
          "value": "022-655 7654"
        },
        {
          "system": "email",
          "value": "KNO@burgersumc.nl"
        },
        {
          "system": "fax",
          "value": "022-655 0998"
        }
      ],
      "address": {
        "line": [
          "West Wing, floor 5"
        ]
      }
    }
  ]
}
Example #4
Input CSV
Organization,5,"f201",true,"Artis University Medical Center (AUMC)",,,,,,,,,,,,,,
identifier,"official",,,,,,,"http://www.zorgkaartnederland.nl/","Artis University Medical Center",,
type,"http://snomed.info/sct",,"405608006","Academic Medical Center",,
telecom,"phone","+31715269111","work",,,
address,"work",,,"Walvisbaai 3","Den Helder",,,"2333ZA","NLD",,
contact,,,,,,,"official","Professor Brand","Brand","Ronald","Prof.Dr.",,,,"phone","+31715269702","work",,,,,,,"Walvisbaai 3","Den helder",,,"2333ZA","NLD",,
Resulting resource
{
  "resourceType": "Organization",
  "id": "f201",
  "identifier": [
    {
      "use": "official",
      "system": "http://www.zorgkaartnederland.nl/",
      "value": "Artis University Medical Center"
    }
  ],
  "active": true,
  "type": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "405608006",
          "display": "Academic Medical Center"
        },
        {
          "system": "urn:oid:2.16.840.1.113883.2.4.15.1060",
          "code": "V6",
          "display": "University Medical Hospital"
        },
        {
          "system": "http://terminology.hl7.org/CodeSystem/organization-type",
          "code": "prov",
          "display": "Healthcare Provider"
        }
      ]
    }
  ],
  "name": "Artis University Medical Center (AUMC)",
  "telecom": [
    {
      "system": "phone",
      "value": "+31715269111",
      "use": "work"
    }
  ],
  "address": [
    {
      "use": "work",
      "line": [
        "Walvisbaai 3"
      ],
      "city": "Den Helder",
      "postalCode": "2333ZA",
      "country": "NLD"
    }
  ],
  "contact": [
    {
      "name": {
        "use": "official",
        "text": "Professor Brand",
        "family": "Brand",
        "given": [
          "Ronald"
        ],
        "prefix": [
          "Prof.Dr."
        ]
      },
      "telecom": [
        {
          "system": "phone",
          "value": "+31715269702",
          "use": "work"
        }
      ],
      "address": {
        "line": [
          "Walvisbaai 3",
          "Gebouw 2"
        ],
        "city": "Den helder",
        "postalCode": "2333ZA",
        "country": "NLD"
      }
    }
  ]
}
Example #5
Input CSV
Organization,4,"f203",true,"Blijdorp Medisch Centrum (BUMC)",,,,,,,,,,,,,,
identifier,"official",,,,,,"Zorginstelling naam","http://www.zorgkaartnederland.nl/","Blijdorp MC",,
type,"http://snomed.info/sct",,"405608006","Academic Medical Center",,
telecom,"phone","+31107040704","work",,,
address,"work",,,"apenrots 230","Blijdorp",,,"3056BE","NLD",,
Resulting resource
{
  "resourceType": "Organization",
  "id": "f203",
  "identifier": [
    {
      "use": "official",
      "type": {
        "text": "Zorginstelling naam"
      },
      "system": "http://www.zorgkaartnederland.nl/",
      "value": "Blijdorp MC"
    }
  ],
  "active": true,
  "type": [
    {
      "coding": [
        {
          "system": "http://snomed.info/sct",
          "code": "405608006",
          "display": "Academic Medical Center"
        },
        {
          "system": "http://terminology.hl7.org/CodeSystem/organization-type",
          "code": "prov"
        }
      ]
    }
  ],
  "name": "Blijdorp Medisch Centrum (BUMC)",
  "telecom": [
    {
      "system": "phone",
      "value": "+31107040704",
      "use": "work"
    }
  ],
  "address": [
    {
      "use": "work",
      "line": [
        "apenrots 230"
      ],
      "city": "Blijdorp",
      "postalCode": "3056BE",
      "country": "NLD"
    }
  ]
}