---
title: "List groups in a practitioner's relationship graph"
method: GET
path: "/practitioners/{id}/relationships/groups"
tags: ["Practitioner"]
---

# List groups in a practitioner's relationship graph

`GET /practitioners/{id}/relationships/groups`

Returns all groups that the practitioner belongs to, including core group attributes such as name, NPI, TIN, and active status, plus metadata for each group. Use this when you need groups with their full attribute data as part of the practitioner's relationship graph; to retrieve just group membership without the attribute detail, use `GET /practitioners/{practitionerId}/groups` instead. `{id}` is the `certifyPractitionerId` and the caller must hold the `READ_PRACTITIONER` permission.

## Path parameters

- `id` string, required

## Headers

- `tenant-id` string

## Response `200`

An array of group relationship objects including identifiers and core group attributes.

- PractitionerGroupsResponseSchema — Response containing groups that a practitioner belongs to. Each group represents a group operational value with core group data and metadata.
  - `data` GroupOVResponse[], required — Array of groups the practitioner belongs to. Each group is a GroupOVResponse containing the group's operational value data.
    - `certifyGroupId` string, required — The unique Certify identifier for the group (certifyPractitionerId equivalent for groups)
    - `tenantId` string, required — The tenant identifier that owns this group relationship
    - `data` CoreGroupOperationalValueDataBaseSchema — Foundation schema defining properties for core group operational value data.
      - `affiliation` string — Affiliation name or code associated with the group.
      - `npi` string — The National Provider Identifier (NPI) of the group. The NPI is a unique 10-digit identification number issued to healthcare providers by the Centers for Medicare and Medicaid Services (CMS).
      - `name` string — The name of the group or healthcare organization.
      - `tin` string — The Tax Identification Number (TIN) of the group. This is typically an Employer Identification Number (EIN) issued by the Internal Revenue Service (IRS).
      - `type` string — The type or classification of the group (e.g., 'Multi-specialty', 'Single-specialty', 'Hospital', etc.).
      - `legalTaxName` string — The legal tax name of the group as registered with tax authorities. This is the official name used for tax reporting purposes.
      - `active` boolean — Indicates whether the group is currently active and operational. Inactive groups are typically those that have been terminated or are no longer providing services.
      - `telemedicineAvailable` boolean — Indicates whether the group offers telemedicine services. When true, the group provides remote healthcare services via telecommunications technology.
      - `taxInfo` TaxInfoSchema — Represents the legal tax entity information associated with a group.
        - `legalTaxName` string, required — Legal tax name
        - `taxEntityStates` string[], required — States where the tax entity operates
        - `irs575File` string, required — Reference to the IRS 575 file
        - `w9File` string, required — Reference to the W9 file
      - `bedCount` integer — The number of beds available at the group's facility. This is typically relevant for hospitals, nursing homes, and other inpatient facilities.
      - `dea` string — The Drug Enforcement Administration (DEA) registration number. This is required for healthcare providers who prescribe, dispense, or handle controlled substances.
    - `contributingSlices` object — Internal metadata about data sources that contributed to this group's operational value. Structure is implementation-specific.
  - `links` PageLinks2, required — Navigation links for the response
    - `self` string, uri, required — Link to the current page of results
    - `next` string, uri, nullable — Link to the next page of results, or null if this is the last page
    - `prev` string, uri, nullable — Link to the previous page of results, or null if this is the first page
  - `totalCount` integer, nullable — Total number of groups the practitioner belongs to (if available). May be null if the total count is not provided.

## Other responses

- `401` — Unauthorized - Authentication required
- `403` — Forbidden - Authenticated but lacking READ_PRACTITIONER permissions
- `404` — Practitioner not found for the given {id} and tenant-id
- `500` — Internal server error

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/563848e0ecc0/schema)