> ## Documentation Index
> Fetch the complete documentation index at: https://docs.range.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Risk Configuration

> Returns the workspace risk configuration including exposure signals, behaviours, tier thresholds, and defaults.



## OpenAPI

````yaml get /v2/risk/config
openapi: 3.0.0
info:
  title: Range Risk API
  description: The Range Risk API for risk assessment of crypto addresses.
  version: 1.7.29
  contact: {}
servers:
  - url: https://api.range.org
    description: Range API Server
security:
  - Authorization: []
tags:
  - name: Risk
    description: Get risk information about a crypto address.
  - name: Risk v2
    description: >-
      Address risk assessment, workspace configuration, and signals catalogue
      (API v2).
  - name: Simulator
    description: Simulate a transaction on a network.
paths:
  /v2/risk/config:
    get:
      tags:
        - Risk v2
      summary: Get Workspace Risk Configuration
      description: >-
        Returns the active risk configuration for your workspace. A workspace
        with no stored config is seeded with the catalogue defaults on first
        read and that config is returned. Missing default behaviours are
        appended to an already-stored config on read; attribution/exposure
        signals added to the catalogue later reach already-stored configs via
        backfill migrations, not automatically.
      operationId: getConfig
      parameters: []
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RiskConfigSpecDto'
components:
  schemas:
    RiskConfigSpecDto:
      type: object
      properties:
        workspace_id:
          type: string
          example: ws-12345
        attribution_signals:
          type: array
          items:
            $ref: '#/components/schemas/AttributionConfigDto'
        exposure_signals:
          type: array
          items:
            $ref: '#/components/schemas/ExposureConfigDto'
        behaviours:
          type: array
          items:
            $ref: '#/components/schemas/BehaviourConfigDto'
        case_auto_create:
          description: >-
            Whether a risk_screen result at or above min_tier auto-creates a
            case.
          allOf:
            - $ref: '#/components/schemas/CaseAutoCreateConfigDto'
        updated_at:
          type: string
          example: '2026-05-18T10:00:00Z'
      required:
        - workspace_id
        - attribution_signals
        - exposure_signals
        - behaviours
        - case_auto_create
        - updated_at
    AttributionConfigDto:
      type: object
      properties:
        signal:
          type: string
          example: sanctions_ofac
        enabled:
          type: boolean
          example: true
        severity:
          type: string
          example: severe
          enum:
            - severe
            - high
            - medium
            - low
      required:
        - signal
        - enabled
        - severity
    ExposureConfigDto:
      type: object
      properties:
        signal:
          type: string
          example: obfuscation
        enabled:
          type: boolean
          example: true
        thresholds:
          description: Maps observed exposure fraction (0-1) to severity.
          allOf:
            - $ref: '#/components/schemas/SeverityThresholdsMapDto'
        floor_usd:
          type: number
          minimum: 0
          example: 1000
          description: >-
            Minimum exposed USD required for the signal to fire even when the
            exposure % threshold is met. Defaults to 0 when omitted.
      required:
        - signal
        - enabled
        - thresholds
    BehaviourConfigDto:
      type: object
      properties:
        behaviour:
          type: string
          example: smurfing
        enabled:
          type: boolean
          example: true
        thresholds:
          description: >-
            Maps detection confidence (0-1) to severity. Below low threshold =
            none.
          allOf:
            - $ref: '#/components/schemas/SeverityThresholdsMapDto'
        ignore:
          type: boolean
          example: false
          description: Detect but do not include in severity determination
        tokens:
          description: >-
            Watched token asset ids (lowercase). Used only by watched-token.
            Empty/omitted = no matches.
          example:
            - 0xabc…
            - usdc
          type: array
          items:
            type: string
      required:
        - behaviour
        - enabled
        - thresholds
        - ignore
    CaseAutoCreateConfigDto:
      type: object
      properties:
        enabled:
          type: boolean
          example: false
        min_tier:
          type: string
          example: high
          enum:
            - severe
            - high
            - medium
            - low
      required:
        - enabled
        - min_tier
    SeverityThresholdsMapDto:
      type: object
      properties:
        low:
          type: number
          minimum: 0
          example: 0.01
        medium:
          type: number
          minimum: 0
          example: 0.05
        high:
          type: number
          minimum: 0
          example: 0.2
        severe:
          type: number
          minimum: 0
          example: 0.5
      required:
        - low
        - medium
        - high
        - severe
  securitySchemes:
    Authorization:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Authorization method required to allow user to access the api endpoints.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.