---
title: Verify
description: Sellers and gateways call one endpoint and get an answer in under 50 ms.
canonical: https://tollrelay.com/docs/verify
lastmod: 2026-09-15
---

# Verify

Sellers and gateways call one endpoint and get an answer in under 50 ms.

A seller runs a gate before it serves. One call says whether the pass is good and what the mandate has left. TollRelay never charges and never settles.

```http
POST https://api.trlay.dev/verify
{ "identity_jwt": "…", "seller_id": "api.exa.ai", "endpoint": "/search", "amount_usd": "0.020", "rail": "x402", "settlement_ref": "eip155:8453:0x…" }
```

The answer says whether the pass is valid, which organisation and agent it belongs to, the verification state, the mandate remaining, and a receipt id to write into your record.

## Offline

Check the pass against the public keys at https://api.trlay.dev/.well-known/jwks.json. No call, no dependency on uptime for the identity.

## Online

Call /verify for revocation, reputation and the mandate remaining. For a paid call, send the settlement reference; TollRelay records it and does not settle it.

## A seller that charges by 402

Declare the `tollrelay-identity` extension in the 402 payment requirements. The agent sends `X-Trlay-Identity` with its payment. After settlement, call verify with the settlement reference from the payment response, as `network:transaction`. TollRelay never pays and never settles.

## Pricing

A gate pays per check.

- First 10,000 checks a month: free.
- To 1 million: $0.001 per check.
- To 10 million: $0.0005 per check.
- Beyond: $0.0002 per check.