---
title: "List Access Risk Settings"
method: GET
path: "/api/v2/access-risk-settings"
tags: ["Access Risk Settings"]
---

# List Access Risk Settings

`GET /api/v2/access-risk-settings`

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/access-risk-settings`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/access-risk-settings/get.ts> (a function with typed inputs; its response is checked against the schema)

Get Access Risk Detection organization settings for the current organization. Returns all settings from the `identity_risk_detection` feature, including the master `enabled` toggle. Optional filters can narrow results to a subset of settings.

#### Sample Request
```
curl -X GET '{baseUrl}/access-risk-settings' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key:{API_KEY}'
```

#### Sample Request (filtered)
```
curl -X GET '{baseUrl}/access-risk-settings?filter=setting.name:eq:trusted_ip_lists' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key:{API_KEY}'
```

#### Sample Response
```json
{
  "features": [
    {
      "name": "identity_risk_detection",
      "settings": [
        {
          "name": "enabled",
          "value": true
        },
        {
          "name": "trusted_ip_lists",
          "value": ["203.0.113.0/24"]
        }
      ],
      "category": "itdr"
    }
  ]
}
```

## Query parameters

- `filter` string[]

## Response `200`

Success retrieving Access Risk settings.

- JumpcloudOrganizationSettingsListFeatureSettingsResponse
  - `features` JumpcloudOrganizationSettingsFeature[]
    - `category` string
    - `name` string
    - `settings` JumpcloudOrganizationSettingsSetting[]
      - `name` string
      - `value` unknown

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/revisions/f396d9271b46?raw)