Security Guidance

Practical advice to recognise and prevent scams

API Documentation

Endpoints, entity types, and quick start guide

Platform Setup Guides

Telegram, Discord, Slack, and WhatsApp integration

Terms and Conditions

Service agreement and acceptable use policies

Privacy Policy

How we collect, use, and protect your data

Security

Security Guidance

Our practical guide to recognising scams, verifying before you trust, protecting your digital identity, and responding fast now lives in the AVA Academy.

Read: Staying safe online, a practical security guide →

Browse all free lessons at the AVA Academy.

API

API Documentation

Check any entity programmatically with the AVA REST API.

Quick Start

Check any entity with a single API call:

curl -X POST https://api.checkwithava.com/v1/screen \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_KEY" \
  -d '{"entity_value": "suspicious-domain.com"}'

The response includes a risk score (0-100), risk level, confidence rating, and detailed signal breakdown.

Endpoints

  • POST /v1/screen - Synchronous check (full pipeline, returns verdict)
  • POST /v1/screen/async - Async check (returns job ID, optional webhook callback)
  • POST /v1/screen/batch - Batch up to 100 entities per request
  • GET /v1/jobs/{id} - Poll async job status
  • GET /v1/graph/{type}/{value} - Relationship graph (BFS traversal)
  • GET /v1/history - Recent check history
  • GET /v1/audit/{id} - Full check audit record
  • GET /v1/audit/export - Compliance-ready CSV export
  • POST /v1/report - Community scam report (cross-platform)

Entity Types

AVA auto-detects entity type, or you can specify explicitly:

  • domain - example.com
  • url - https://example.com/page
  • wallet - ETH (0x...), BTC, SOL addresses
  • email - user@example.com
  • ip_address - IPv4 addresses
  • phone - International format (+61...)
  • social_account - platform:handle (e.g. x:@handle, instagram:handle)
Platforms

Platform Setup Guides

Step-by-step instructions for each supported messaging platform.

Telegram Bot Setup and Commands

Setup (30 seconds):

  1. Add @CheckWithAvaBot to your Telegram group
  2. Make the bot an admin (required for reading messages and enforcing policies)
  3. Done. Monitoring starts automatically.

Everyday

  • /check <entity> - Check if a URL, domain, wallet, or email is a scam
  • /report <entity> - Report a suspected scam (available to all group members)
  • /status - View monitoring stats and queue depth

Admin (group admins only)

  • /protect - Quick-start monitoring with default policy
  • /monitor / /unmonitor - Start or stop monitoring
  • /policy <notify|delete|ban> - Set action policy
  • /alerts <here|me|chat_id> - Set where alerts are sent
  • /antiraid <joins> <minutes> - Configure anti-raid thresholds
  • /welcome on|off|set <text> - Configure welcome messages
  • /learn [days] - Observe channel behaviour before monitoring
  • /connect <api_key> - Bind this channel to your paid AVA plan

Security (group admins only)

  • /audit - Scan members for admin impersonation
  • /verify <user> - Check if a user is a real admin
  • /banuser <user> - Ban a suspected impersonator

Content Control (group admins only)

  • /blocklist add|remove|clear <pattern> - Manage custom blocklist patterns
  • /allowlist user|domain <value> - Manage approved users and domains

Audit (group admins only)

  • /setlog <channel> - Configure audit log channel
  • /settings - View all bot settings for this group

Account

  • /subscribe - Upgrade your plan via Telegram Stars
  • /support <issue> - Create a support ticket
  • /start - Bot info and all commands

Personal scanning (DM the bot): Forward a suspicious message or paste a URL, wallet, or domain directly. The bot replies with a risk verdict for each entity found.

Discord Bot Integration

Slash commands with ephemeral responses. Requires Starter plan ($29/mo) or higher.

  • /checkwithava <entity> - Check if something is a scam
  • /monitor / /unmonitor - Start or stop monitoring a channel
  • /policy <notify|delete|ban> - Set action policy
  • /report <entity> [reason] - Report a suspected scam
  • /connect <api_key> - Bind this channel to your paid AVA plan
  • /audit - Scan members for admin impersonation
  • /learn - Start learning mode

Slack Bot Integration

Workspace integration with slash commands. Requires Pro plan ($99/mo) or higher.

  • /ava-check <entity> - Check if something is a scam
  • /ava-monitor / /ava-unmonitor - Start or stop monitoring
  • /ava-policy <notify> - Set action policy
  • /ava-report <entity> - Report a suspected scam
  • /ava-connect <api_key> - Connect to your paid AVA account
  • /ava-learn - Start learning mode

WhatsApp Bot Integration

Meta Cloud API integration with text commands. Requires Starter plan ($29/mo) or higher.

  • !ava status - Show monitoring status
  • !ava monitor / !ava unmonitor - Start or stop monitoring
  • !ava policy <notify> - Set action policy
  • !ava report <entity> - Report a suspected scam
  • !ava admin add <phone> - Add an admin

The user who first connects the group is automatically the admin.

Legal

Terms and Conditions

Last updated: April 2026. Please read these terms carefully before using AVA.

1. Agreement to Terms

By accessing or using AVA ("the Service"), operated by Check With AVA ("we", "us", "our") at checkwithava.com, you agree to be bound by these Terms & Conditions. If you do not agree, do not use the Service.

We reserve the right to modify these terms at any time. Continued use of the Service after changes constitutes acceptance of the updated terms.

2. Service Description

AVA is an entity verification and scam detection platform that checks domains, URLs, wallet addresses, social media accounts, emails, IP addresses, and other digital entities for fraud indicators and risk signals.

IMPORTANT: AVA provides risk indicators for informational purposes only. AVA does NOT provide legal, financial, investment, or professional advice of any kind. Trust Scores and risk levels are automated assessments based on available data. They are not guarantees of safety or danger.

You are solely responsible for your own decisions. Always verify independently before sending money, sharing personal information, or engaging with any entity.

3. User Accounts & Plans

  • You must provide accurate information when creating an account via social login.
  • You are responsible for maintaining the security of your account and API keys.
  • Free accounts are subject to usage limits. Paid plans provide higher limits as described on the Pricing page.
  • We reserve the right to suspend or terminate accounts that violate these terms or exhibit abusive usage patterns.

4. Acceptable Use

You agree NOT to:

  • Use the Service to harass, stalk, or target individuals
  • Reverse engineer, scrape, or extract AVA's detection logic or intelligence data
  • Use the API to build a competing service
  • Submit false or misleading entities to manipulate AVA's threat intelligence
  • Attempt to circumvent rate limits, authentication, or access controls
  • Use the Service for any unlawful purpose

5. Billing, Refunds & Liability

  • Paid subscriptions are billed monthly via Stripe. Prices are in USD unless otherwise stated.
  • You may cancel at any time. Cancellation takes effect at the end of the current billing period.
  • Refunds are provided at our discretion within 14 days of initial purchase.
  • Telegram Stars purchases are processed through Telegram's payment system. Refunds via /paysupport or support@checkwithava.com within 14 business days.

NO WARRANTY. THE SERVICE IS PROVIDED "AS IS" WITHOUT WARRANTIES OF ANY KIND. WE DO NOT WARRANT THAT ANY RISK ASSESSMENT WILL BE ACCURATE, COMPLETE, OR ERROR-FREE.

LIMITATION OF LIABILITY. TO THE MAXIMUM EXTENT PERMITTED BY LAW, OUR TOTAL AGGREGATE LIABILITY SHALL NOT EXCEED THE GREATER OF THE AMOUNT YOU PAID IN THE 12 MONTHS PRECEDING THE CLAIM, OR AUD $100.

Contact: legal@checkwithava.com. Governed by the laws of Australia.

Legal

Privacy Policy

Last updated: April 2026. How we collect, use, and protect your information.

1. Information We Collect

Account information: When you sign in via social login, we receive your name, email address, and profile picture. We do not receive or store your password.

Check data: Entities you submit to check are processed and stored to generate risk verdicts and improve our threat intelligence.

Telegram data: If you use the Telegram bot, we process message content in monitored channels to extract and check entities. We do not store full message content.

2. How We Use Your Data

  • Provide the Service: Process checks, generate verdicts, maintain your account
  • Improve detection: Check results contribute to our threat intelligence graph. Entity data is anonymised in public-facing insights.
  • Security: Detect and prevent abuse, fraud, and prompt injection attacks

We do NOT sell your personal data. We do NOT use your data for advertising.

3. Cookies, Data Sharing & Retention

Cookies: One essential session cookie (ava_session), httpOnly and secure. No tracking cookies, no Google Analytics, no advertising cookies.

Data sharing: Only with independent reputation and threat-intelligence providers (which receive the entity you check, never your personal data), our payment processor (Stripe), email provider (Resend), cloud infrastructure (AWS, Cloudflare), and law enforcement if required by law. No data brokers or advertisers.

Retention: Account data retained while active, deleted within 30 days of deletion request. Check verdicts retained indefinitely as anonymised threat intelligence. Sessions expire after 72 hours.

4. Your Rights

Under GDPR and the Australian Privacy Act, you have the right to: access, rectification, erasure, portability, objection, and withdrawal of consent.

You have the right to request human review of any automated assessment.

In the event of a data breach, we will notify the relevant supervisory authority within 72 hours and affected individuals within 30 days.

Contact: privacy@checkwithava.com. We respond to all privacy requests within 30 days.

Start protecting your community today.

Free. No signup required. Add AVA to your group and it starts working immediately.

Add to Telegram