---
title: "List groups matching filter criteria"
method: GET
path: "/groups"
tags: ["Group"]
---

# List groups matching filter criteria

`GET /groups`

Returns a paginated list of groups for the requesting tenant that match all supplied filter criteria (filters are combined with AND semantics); all filters are optional, and omitting them returns every group for the tenant. Use this endpoint to enumerate or search across groups; for a known certifyGroupId use GET /groups/{id}, and for autocomplete-style name/NPI/TIN prefix search use GET /groups/search. Pagination is offset-based via page and size; the default page size is 2 and no maximum page size is enforced.

## Query parameters

- `affiliation` string
- `locationName` string
- `locationNpi` string
- `name` string
- `npi` string
- `page` integer
- `size` integer
- `tin` string
- `type` string

## Headers

- `tenant-id` string

## Response `200`

Paginated envelope of group records matching the supplied filters

- PagedResponse
  - `data` unknown[] — The page of results for this request.
    - unknown
  - `totalCount` integer — Total number of records matching the request, across all pages.
  - `identifiersSearched` integer — Count of identifiers submitted for a bulk-identifier search (e.g. bulk NPI search). Omitted/null for standard (non-bulk) list requests.
  - `matchedCount` integer — Count of submitted identifiers that matched a record. Omitted/null for standard (non-bulk) list requests.
  - `notFoundCount` integer — Count of submitted identifiers that did not match any record. Omitted/null for standard (non-bulk) list requests.
  - `unmatchedIdentifiers` string[] — Submitted identifiers that did not match any record. Omitted/null for standard (non-bulk) list requests.

## Other responses

- `401` — Unauthorized - User is not authenticated

---

[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)