72.4.1Create Group Resources

FHIR Group resources represent member attribution and access control for provider systems. Groups determine which members a provider system can access via the $davinci-data-export operation.

72.4.1.1Create Group Resources

1. Access the FHIR repository in the Smile CDR instance.
2. Create a new Group resource for the provider system.
3. Specify identifying information, including:
   • Name of the provider system or group.
   • NPI or other business identifiers.
   • Client ID (matches the registered provider system).
4. Assign members to each group according to the payer’s attribution list.

Example Group Resource

{
  "resourceType": "Group",
  "id": "Example-PDex-Provider-Group",
  "meta": {
    "versionId": "2",
    "lastUpdated": "2025-10-20T16:25:43.203-04:00",
    "source": "#owxMFHPObxM1Stzx",
    "profile": [
      "http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/pdex-provider-group"
    ]
  },
  "extension": [
    {
      "url": "http://hl7.org/fhir/us/davinci-atr/StructureDefinition/ext-attributionListStatus",
      "valueCode": "final"
    },
    {
      "url": "http://hl7.org/fhir/us/davinci-pdex/StructureDefinition/base-ext-members-opted-out",
      "valueQuantity": {
        "value": 5
      }
    }
  ],
  "identifier": [
    {
      "system": "http://hl7.org/fhir/sid/us-npi",
      "value": "1356441356"
    },
    {
      "system": "urn:oid:2.16.840.1.113883.4.4",
      "value": "1234"
    }
  ],
  "active": true,
  "type": "person",
  "actual": true,
  "code": {
    "coding": [
      {
        "system": "http://hl7.org/fhir/us/davinci-pdex/CodeSystem/PdexMemberAttributionCS",
        "code": "pdexprovidergroup",
        "display": "PDex Provider Group"
      }
    ]
  },
  "name": "Attributed List of Health Plan Members for Practitioner 1356441356.",
  "managingEntity": {
    "reference": "Organization/payer-organization-1"
  },
  "characteristic": [
    {
      "code": {
        "coding": [
          {
            "system": "http://hl7.org/fhir/us/davinci-pdex/CodeSystem/PdexMemberAttributionCS",
            "code": "pdexprovidergroup",
            "display": "PDex Provider Group"
          }
        ]
      },
      "valueReference": {
        "identifier": {
          "system": "http://hl7.org/fhir/sid/us-npi",
          "value": "1356441356"
        }
      },
      "exclude": false,
      "period": {
        "start": "2024-03-21"
      }
    }
  ],
  "member": [
    {
      "id": "1",
      "entity": {
        "reference": "Patient/payer-patient-1"
      }
    },
    {
      "id": "2",
      "entity": {
        "reference": "Patient/payer-patient-2"
      }
    },
    {
      "id": "3",
      "entity": {
        "reference": "Patient/payer-patient-3"
      }
    }
  ]
}

Notes:

• For a standardized structure and additional guidance, refer to the PDex Provider Group profile
• Properly configured Group resources ensure the Provider Access API only exports data for attributed members.