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

# Get risk analysis result

> Polls the status and result of an asynchronous risk analysis job.

<Note>
  Poll this endpoint to check the status of an async risk analysis started with [Start risk analysis](/api-reference/endpoint/create-risk-analysis).
</Note>

## Status values

| Status      | Description                                                     |
| ----------- | --------------------------------------------------------------- |
| `pending`   | Job is queued and waiting to start                              |
| `running`   | Analysis is in progress                                         |
| `completed` | Analysis finished successfully. `result` contains the risk data |
| `failed`    | Analysis failed. `error` contains the failure reason            |

## Response fields

| Field             | Type   | Description                                                     |
| ----------------- | ------ | --------------------------------------------------------------- |
| `address`         | string | Wallet address being analyzed                                   |
| `status`          | string | Job status (pending, running, completed, failed)                |
| `result`          | object | Risk analysis result when status is `completed`                 |
| `result.risk`     | number | Risk score from 0 to 100                                        |
| `result.reason`   | string | Explanation of the risk score                                   |
| `result.patterns` | array  | Detected suspicious patterns with severity and involved wallets |
| `error`           | string | Error message when status is `failed`                           |
| `createdAt`       | number | Job creation timestamp (unix ms)                                |
| `updatedAt`       | number | Last update timestamp (unix ms)                                 |

## Related resources

<CardGroup cols={2}>
  <Card title="Start risk analysis" icon="play" href="/api-reference/endpoint/create-risk-analysis">
    Start a new async risk analysis job.
  </Card>

  <Card title="Quick risk" icon="bolt" href="/api-reference/endpoint/get-risk-quick">
    Synchronous risk check for fast single-address analysis.
  </Card>

  <Card title="Risk scores" icon="gauge" href="/concepts/risk">
    Learn how risk scores are calculated and interpreted.
  </Card>
</CardGroup>


## OpenAPI

````yaml GET /risk/{jobId}
openapi: 3.1.0
info:
  title: Wavy Node API
  description: >-
    Compliance, fraud prevention, and risk analysis API for payment providers
    and cryptocurrency exchanges in Latin America.
  version: 1.0.0
  contact:
    name: Wavy Node Support
    email: support@wavynode.com
servers:
  - url: https://api.wavynode.com/v1
    description: Production
security:
  - apiKeyAuth: []
paths:
  /risk/{jobId}:
    get:
      tags:
        - Risk Analysis
      summary: Get risk analysis result
      description: >-
        Polls the status and result of an asynchronous risk analysis job.
        Returns pending, running, completed, or failed status.
      operationId: getRiskAnalysisResult
      parameters:
        - name: jobId
          in: path
          required: true
          description: The job ID returned from POST /risk
          schema:
            type: string
      responses:
        '200':
          description: Risk analysis job result
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    $ref: '#/components/schemas/RiskJobResult'
        '404':
          description: Job not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    RiskJobResult:
      type: object
      properties:
        address:
          type: string
          description: Wallet address being analyzed
        status:
          type: string
          enum:
            - pending
            - running
            - completed
            - failed
          description: Current status of the analysis job
        result:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/RiskResultData'
          description: Analysis result (null if status is not completed)
        error:
          type: string
          nullable: true
          description: Error message if status is failed
        createdAt:
          type: number
          description: Job creation timestamp (unix ms)
        updatedAt:
          type: number
          description: Last update timestamp (unix ms)
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: string
          description: Error code
        message:
          type: string
          description: Error description
    RiskResultData:
      type: object
      properties:
        risk:
          type: number
          description: Risk score from 0 to 100
        reason:
          type: string
          nullable: true
          description: Explanation of the risk score
        patterns:
          type: array
          items:
            $ref: '#/components/schemas/RiskPattern'
          description: Detected suspicious patterns
    RiskPattern:
      type: object
      properties:
        name:
          type: string
          description: Pattern name (e.g. mixing, peel_chain)
        severity:
          type: string
          description: Severity label (e.g. critical, high, medium, low)
        involvedWallets:
          type: array
          items:
            type: string
          description: Wallet addresses involved in this pattern
        involvedTxs:
          type: array
          items:
            type: string
          description: Transaction hashes involved in this pattern
        usdAmount:
          type: number
          description: USD volume involved in this pattern
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Enter the full value with the `ApiKey` prefix. Example: `ApiKey
        wavy_your-api-key`. The prefix is required for authentication.

````