# GuardAccess
> Email and phone validation API for AI agents and businesses.

GuardAccess validates email addresses and phone numbers, looks up IPs and domains, scores sign-up fraud risk, and matches a person's name to their mobile money / bank account name (match_name). Each result has `agent_action`: 'accept' (use it), 'confirm_with_user' (read `reasons` and `did_you_mean` back to the user), 'ask_user_for_country' (ask which country the number is from, then retry with default_country), 'reject_if_signup_else_confirm' (disposable inbox), or 'reject'. Never silently 'fix' a contact: if `did_you_mean` is set, ask the user before using it. Batch up to 100 values with validate_contacts.

## Get a key
POST https://veriq-u2at.onrender.com/signup {"email": "you@company.com", "source": "agent"} -> {"api_key": "ga_live_..."} (250 free credits)

## Endpoints (Authorization: Bearer <key>, JSON body, 1 credit per value)
- POST https://veriq-u2at.onrender.com/v1/email  {"email": "..."}
- POST https://veriq-u2at.onrender.com/v1/phone  {"phone": "...", "default_country": "US"}
- POST https://veriq-u2at.onrender.com/v1/validate  {"value": "..."}  (auto-detect)
- POST https://veriq-u2at.onrender.com/v1/batch  {"values": ["...", "..."]}  (max 100)
- POST https://veriq-u2at.onrender.com/v1/ip  {"ip": "8.8.8.8"}  (1 credit)
- POST https://veriq-u2at.onrender.com/v1/domain  {"domain": "acme.com"}  (2 credits)
- POST https://veriq-u2at.onrender.com/v1/signup-risk  {"email": "...", "phone": "...", "ip": "...", "name": "optional"}  (3 credits, + name match credits if name sent)
- POST https://veriq-u2at.onrender.com/v1/name-match  {"name": "Kwame Mensah", "country": "GH", "phone": "0241234567", "network": "MTN"}  or account_number + bank
  (3 credits when a Ghana mobile money name is resolved and scored; 1 credit for name_unavailable fallback signals elsewhere in Africa and the USA; 0 if unresolved)
- GET  https://veriq-u2at.onrender.com/v1/name-match/coverage  (free) countries with real name match vs fallback
- POST https://veriq-u2at.onrender.com/v1/bulk  multipart CSV upload (max 50,000 rows), returns cleaned CSV
- GET  https://veriq-u2at.onrender.com/v1/account
- OpenAPI: https://veriq-u2at.onrender.com/openapi.json
- MCP (streamable HTTP): https://veriq-u2at.onrender.com/mcp/