---
title: "Search groups by name, NPI, or TIN"
method: GET
path: "/groups/search"
tags: ["Group"]
---

# Search groups by name, NPI, or TIN

`GET /groups/search`

Returns a paginated list of groups whose name (substring), NPI (prefix), or TIN (prefix) matches the supplied query term. Results are suitable for use in autocomplete dropdowns where the user needs to disambiguate groups with similar names. The stored reference for a selected group is the 'id' field (certifyGroupId).

## Query parameters

- `page` integer
- `q` string, required
- `size` integer

## Headers

- `tenant-id` string

## Response `200`

Paginated list of matching groups

- 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

- `400` — Invalid request — q is required, must be 2–128 chars; page and size must be non-negative
- `401` — Unauthorized

---

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