List practitioners matching filter criteria
GET/practitioners
Returns a paginated list of practitioners matching the supplied filter criteria; all filters are combined with AND logic, and omitting a filter returns all practitioners accessible to the caller. Use this endpoint to search across practitioners by name, NPI, CAQH ID, external ID, type, roles, or delegation status — for a single known practitioner, prefer GET /practitioners/{id} instead, and for bulk NPI lookup, supply multiple npi values (the response shape changes when NPI bulk-search mode is active, adding identifiersSearched and matchedCount fields). The tenant-id header identifies which tenant's data is queried; include the X-PII-View: true header to receive PII fields, which requires the practitioner read:pii permission — callers without it receive 403. The size parameter's default of 2 is intentional, and unlike the NPI bulk-search and roster-ID list parameters, api-layer does not enforce any maximum on size — it is passed through unclamped.
Request
Responses
- 200
- 400
- 401
- 403
- 500
List of Practitioner
Invalid pagination parameters, or an NPI bulk-search list that exceeds the configured maximum (default 100 identifiers).
Unauthorized - Authentication required
Forbidden - Insufficient permissions
Internal server error