Skip to main content
Integrate the Predicate API into your backend to evaluate users against your configured policy. The API returns a compliance result and a signed attestation.
1

Backend Integration

Call the Predicate API from your server using your API key.
2

Handle the Response

Use is_compliant to gate access in your application.

​
Backend Integration

Store your API key on the server and call the Predicate API. Use the verification_hash from your project and the user’s wallet address. 
import express from 'express';

const app = express();
app.use(express.json());

app.post('/api/compliance/check', async (req, res) => {
  const { userAddress } = req.body;

  const response = await fetch('https://api.predicate.io/v2/attestation', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'x-api-key': process.env.PREDICATE_API_KEY,
    },
    body: JSON.stringify({
      verification_hash: process.env.PREDICATE_VERIFICATION_HASH,
      from: userAddress,
      chain: 'ethereum',
    }),
  });

  const result = await response.json();

  if (!result.is_compliant) {
    return res.status(403).json({
      error: 'User not compliant',
      policy: result.policy_name
    });
  }

  // User is compliant — proceed with your business logic
  res.json({ compliant: true });
});

​
Request Parameters

FieldRequiredDescription
verification_hashYesYour project identifier from the dashboard
fromYesThe user’s wallet address to evaluate
chainYesChain name (e.g., ethereum, base, arbitrum)

​
Response

{
  "policy_id": "policy_abc123",
  "policy_name": "Standard AML Policy",
  "verification_hash": "x-abc123def456",
  "is_compliant": true,
  "attestation": {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "expiration": 1696640400,
    "attester": "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266",
    "signature": "0x1b2c3d4e5f..."
  }
}
FieldDescription
is_compliantWhether the user passed the policy evaluation
policy_nameName of the policy that was evaluated
attestationSigned attestation (used for onchain enforcement in Phase 2)

​
Supported Chains

ChainValue
Ethereumethereum
Basebase
Arbitrumarbitrum
Hyperliquidhyperliquid
Plumeplume
BSCbsc
Plasmaplasma
Worldworldchain
Sepoliasepolia
Solanasolana
MegaETHmegaeth
MegaETH Testnetmegaeth_testnet

​
Next Steps

Your offchain integration is complete. Your application can now evaluate compliance for any user. When you’re ready to enforce compliance at the smart contract level, continue to Onchain Enforcement.