Skip to main content

Group

Overview​

The Group resource represents a defined collection of entities that may be discussed or acted upon collectively but are not expected to act collectively. This includes patient cohorts, research populations, and other collections of individuals.

Resource Schema​

Key fields in the Group resource:

{
  "resourceType": "Group",
  "id": "example-group-123",
  "active": true,
  "type": "person",
  "actual": true,
  "name": "Diabetes Management Cohort",
  "quantity": 150,
  "characteristic": [
    {
      "code": {
        "coding": [
          {
            "system": "http://snomed.info/sct",
            "code": "44054006",
            "display": "Diabetes mellitus type 2"
          }
        ]
      },
      "valueBoolean": true,
      "exclude": false
    }
  ],
  "member": [
    {
      "entity": {
        "reference": "Patient/123456"
      }
    }
  ]
}

Operations​

The Group resource supports Read and Search operations. Support varies by CareRecord solution.

CareRecord / SolutionReadSearch
GEHRIMED✅✅
myAvatar✅✅
myEvolv✅✅
myUnity✅✅
TheraOffice✅✅

Read​

HTTP Method: GET
URL: /Group/{id}

curl -X GET https://fhir.netsmartcloud.com/uscore/v1/Group/123456 \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

HTTP Method: GET or POST
URL: /Group or /Group/_search

Search Groups
curl -X GET https://fhir.netsmartcloud.com/uscore/v1/Group \
    -H "Authorization: Bearer {token}" \
    -H "Accept: application/fhir+json"

Integration Patterns​

Common Workflows​

  1. Population Management - Manage patient cohorts and populations
  2. Research Studies - Define study populations and participant groups
  3. Quality Measures - Track groups for quality reporting and analytics

Relationships to Other Resources​

Error Handling​

For common errors and troubleshooting guidance, see Common Errors.

Supported Profiles​