The POST /scim/v2/Users/.search endpoint filters for matching user resources by performing a POST against the special .search endpoint and providing a filter value. Pagination directives can also be provided.

The response is formatted as a list response containing zero or more matching user resources in the Resources field. If the request is valid, the response returns a 200 status code, even if no matching resources are found.

The User resource and its attributes are defined in RFC 7643, Section 4.1.