Risk Category Finds
Find several risk categories by name.
Available to: Organization administrators (own organization’s risk categories)
Environments: Demo, Live
Rate Limit: No endpoint-specific limit
Look up multiple risk categories by name in a single call, returning each matching record, including its id. Prefer this over repeated riskCategoryFind calls when you need to resolve several names at once.
Common Failure Scenarios
- A name in
namesthat doesn’t match a risk category, or matches one you can’t access, is left out of the response array. The call still succeeds, so compare the returned records against the names you requested. - The
namesparameter is missing or repeated (HTTP 404). - 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
riskCategoryFindto look up a single risk category by name. - Use
riskCategoryItemsto resolve several risk categories byidinstead.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
names
Response
RiskCategory
name
id
riskCredit
organizationId