# Entity Evaluation

Entity Evaluation API provided by Fraud Prevention lets you evaluate an entity (such as an IP address) against your configured [risk rules](/guides/risk/rules.md) without requiring a full user action. The entity is enriched with third-party intelligence (e.g., geolocation, ASN, VPN/anonymizer signals) and matched against tenant rules in priority order, returning a recommendation (`ALLOW`, `CHALLENGE`, `DENY`, or `TRUST`).
Typical use cases include pre-flight checks (for example, blocking risky IPs at the edge before they reach sensitive endpoints), support tooling, and offline lookups.



## Servers

Sandbox environment
```
https://api.sbx.transmitsecurity.io/risk/v1
```

Production environment (US)
```
https://api.transmitsecurity.io/risk/v1
```

Production environment (EU)
```
https://api.eu.transmitsecurity.io/risk/v1
```

Production environment (CA)
```
https://api.ca.transmitsecurity.io/risk/v1
```

Production environment (AU)
```
https://api.au.transmitsecurity.io/risk/v1
```

## Security

### risk_access_token

An access token generated by the [token endpoint](/openapi/token.openapi/other/getaccesstoken)

Type: http
Scheme: bearer
Bearer Format: JWT

## Download OpenAPI description

[Entity Evaluation](https://developer.transmitsecurity.com/_bundle/openapi/risk/entity-evaluation.openapi.yaml)

## Other

### Evaluate entity

 - [POST /evaluate](https://developer.transmitsecurity.com/openapi/risk/entity-evaluation.openapi/other/evaluateentity.md): Evaluates an entity against the tenant's configured recommendation rules. The entity is enriched with third-party intelligence data and matched against enabled rules in priority order. Only the first matching production rule applies to the returned recommendation. Any matching preview rule is returned separately in preview_rule for impact analysis without affecting the final decision.
If no production rule matches, the recommendation defaults to ALLOW.