Get identity by filter

GET 
/intelligence/v1/identities

Requires tenant license idn:response-and-remediation.

Caution: When Data Segmentation is enabled, generic API Management API keys are not tied to a user identity and may fail or return incomplete data. Use a personal access token or other user-scoped OAuth token. See API keys and Data Segmentation.

Resolves exactly one identity using a single SCIM-style filters expression. Returns an enriched Human or non-human identity (NHI) envelope. Single-clause filters only; unsupported fields or operators return HTTP 400.

Request

Responses

200

Exactly one identity matched.

400

Invalid filters or unsupported filter field or operator.

401

Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.

403

Unauthorized access

404

No identity matched the filter (detailCode IDC_IDENTITY_NOT_FOUND).

409

Multiple identities matched the filter (detailCode IDC_IDENTITY_AMBIGUOUS).

429

Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.

500

Internal or upstream server failure.