---
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-21
---

# Verify

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

A seller runs a check before it serves. One call says whether the pass is good and what the spending limit has left. TollRelay never charges and never moves the money.

```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, whether the organisation is verified, the spending limit remaining, and a receipt id to write into your history.

## Offline

Check the pass against the public keys at `https://api.trlay.dev/.well-known/jwks.json`. No call is needed, so the check does not depend on TollRelay being up.

## Online

Call `/verify` to check revocation, reputation and the spending limit remaining. For a paid call, send the payment reference in `settlement_ref`; TollRelay records it and does not move the money.

## 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 the payment is made, call `/verify` with the reference from the payment response, as `network:transaction`, in `settlement_ref`. TollRelay never pays and never takes payment.

## Pricing

A seller 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.