---
title: "Search provider flags"
method: GET
path: "/v2/flags/search"
tags: ["v2/flags"]
---

# Search provider flags

`GET /v2/flags/search`

Returns a list of provider flags based on advanced filter criteria. Supports filtering by NPI, flag type, name, sub-collection, committee sharing, read status, and date ranges.

## Query parameters

- `offset` number
- `limit` number
- `npi` string
- `flag_type` string[]
- `first_name` string
- `last_name` string
- `sub_collection_name` string[]
- `shared_to_cred_committee` boolean
- `flagReadStatus` 'seen' | 'unseen' | 'all'
- `flagged_date_start` string, date-time
- `flagged_date_end` string, date-time
- `expiration_date_start` string, date-time
- `expiration_date_end` string, date-time

## Headers

- `organization-id` string

## Response `200`

List of provider flags based on advanced filter criteria

- unknown

## Other responses

- `400` — Bad request if filter is invalid.
- `401` — Authorization token is missing or invalid.
- `403` — User does not have permission to access this resource.

---

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