Risk Category Item
Retrieve a risk category by ID.
Available to: Organization administrators (own organization’s risk categories)
Environments: Demo, Live
Rate Limit: No endpoint-specific limit
Resolve a single riskCategoryId to its risk category record. A risk category holds the position limits and risk parameters that apply to the accounts assigned to it.
Common Failure Scenarios
- No risk category matches the
id, or theidis for a risk category you can’t access. Both returnHTTP 404with an empty body, notHTTP 401. - The
idparameter is missing or repeated (HTTP 404), or isn’t a whole number (HTTP 400). - 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
riskCategoryItemsto resolve several IDs in one call. - Use
riskCategoryListto retrieve every risk category in your organization.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
id
Response
RiskCategory
name
id
riskCredit
organizationId