---
title: "Get all the groups that the practitioner belongs to"
method: GET
path: "/practitioners/{id}/relationships/groups"
tags: ["Practitioner"]
---

# Get all the groups that the practitioner belongs to

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

Returns a list of all groups that the practitioner belongs to. Each group contains the group's operational value data including identifiers, core group attributes (name, NPI, TIN, active status, etc.), and metadata.

## Path parameters

- `id` string, required

## Headers

- `tenant-id` string

## Response `200`

Successfully retrieved list of groups the practitioner belongs to

- 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 R:PROV (READ_PROVIDER) 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/versions/3d27e9019c7b/schema)