# evaluateTransactionRisk

Mutation · GraphQL API

Evaluates the risk of a transaction and return a payload that includes details of the risk evaluation.

## Authentication

- SERVER

## Input

- `input` (`EvaluateTransactionRiskInput!`) — required

## Returns [TransactionRiskEvaluatePayload](/braintree/graphql/reference/types/transaction-risk-evaluate-payload)

Top-level output field from evaluating risk for a transaction.

### Returned fields

- `clientMutationId` (`String`): An identifier used to reconcile requests and responses. 255 characters maximum.
- `riskData` (`RiskData`): Risk data evaluated for this transaction.

## Examples

### Evaluate transaction risk

Top-level input fields used for risk evaluation of a transaction.

```graphql
mutation evaluateTransactionRisk($input: EvaluateTransactionRiskInput!) {
  evaluateTransactionRisk(input: $input) {
    clientMutationId
    riskData {
      id
      decision
      decisionReasons
      deviceDataCaptured
      fraudServiceProvider
      liabilityShift {
        responsibleParty
        conditions
      }
      score
    }
  }
}
```

---

[View the complete GraphQL schema on GitHub](https://raw.githubusercontent.com/braintree/graphql-api/refs/heads/master/schema.graphql)