Risk Category Suggest
Suggest risk categories matching a search term.
Available to: Organization administrators (own organization’s risk categories)
Environments: Demo, Live
Rate Limit: No endpoint-specific limit
Return the risk categories you can access that match the search text in t. Use this endpoint to power a type-ahead or search box over risk categories, rather than retrieving the full list and filtering client-side.
The search ignores case and matches from the start of a word in the risk category’s name or its organization’s name. By default, the response returns at most 10 risk categories, even if l is larger. Set l lower to return fewer.
Common Failure Scenarios
- Risk categories you can’t access are left out of the results. The call doesn’t return an error for them.
- The
tparameter is missing or repeated, or thelparameter is repeated (HTTP 404). Anlvalue that isn’t a whole number in the 32-bit range returnsHTTP 500. - The caller’s user type, or the API key’s permissions, can’t read risk categories. This returns
HTTP 401with"Access is denied".
Error Messages
Related Endpoints
- Use
riskCategoryListto retrieve every risk category in your organization. - Use
riskCategoryFindto look up a risk category by its fullname(the match ignores case).
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
t
Text
l
Max number of entities
Response
RiskCategory
name
id
riskCredit
organizationId