---
title: "Find Group by filter criteria with pagination"
method: GET
path: "/groups"
tags: ["Group"]
---

# Find Group by filter criteria with pagination

`GET /groups`

Returns a paginated list of all Groups. Supports both offset-based (page/size) pagination.

## Query parameters

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

## Headers

- `tenant-id` string

## Response `200`

List of Groups

- PagedResponse
  - `data` unknown[]
    - unknown
  - `totalCount` integer
  - `identifiersSearched` integer
  - `matchedCount` integer
  - `notFoundCount` integer
  - `unmatchedIdentifiers` string[]

## 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/3d27e9019c7b/schema)