# FraudCheck API

> FraudCheck is a fraud-screening API for developers. A single request with any combination of IP address, email address, phone number, shipping country, and person/company name returns per-check results, an advisory risk score from 0 to 100, and stable machine-readable reason codes. It returns checks to inform your own decision — never a verdict. Operated by F7 Software, Inc.

FraudCheck returns **checks, not verdicts**: there is no "is_fraud" field, and the score is advisory — you own the decision. Results are derived from publicly available databases and provided as-is to inform your own judgement; they should not be treated as fact. FraudCheck is not a consumer reporting agency, and its output must not be used to determine eligibility for credit, insurance, employment, or housing, or as the sole basis for denying any person a product or service.

**Screening inputs are never stored.** The values submitted for screening (IPs, emails, phone numbers, names) are processed to produce the response and immediately discarded — never written to a database, file, or backup. Only request metadata (timestamp, endpoint, status) is kept, for billing and reporting.

## Endpoints
REST with JSON by default; XML and CSV are available via content negotiation. Authenticated with an API key.
- POST /v1/screen — screen any combination of ip, email, phone, shipping_country, and name in one call
- POST /v1/screen/batch — up to 100 records per call (plan-gated)
- GET /v1/ip/{ip} — IP checks and geolocation
- GET /v1/geo/{ip} — full IP geolocation
- GET /v1/email/{email} — email checks
- GET /v1/phone/{e164} — phone checks
- GET /v1/name/{name} — sanctions name screening for a person or company
- GET /v1/reasons — the live reason-code catalog and current weights

## What each check covers
- IP: origin country, network operator, Tor-exit / datacenter / cloud-hosting / CDN-edge flags, proxy likelihood, and geolocation.
- Email: syntax, whether the domain can receive mail, and disposable / role / freemail detection.
- Phone: validity for its region, line type, carrier, and locality.
- Country: sanctioned-country and high-risk-jurisdiction checks, plus mismatches between the shipping, IP, and phone countries.
- Name: sanctions screening of person and company names, including known aliases. A match is review-worthy — names collide, so it is not proof of identity — and a non-match is not clearance.

## Authentication and integration
- API keys (sent as X-Api-Key or a Bearer token) with per-endpoint scopes, rotation, and optional HMAC request signing; OAuth2 client-credentials is also supported.
- Optional per-credential IP allowlist; plan-based rate limits and a monthly quota with optional metered overage.
- Official SDKs: a typed .NET client on NuGet (FraudCheck.Client) and single-file clients for Python, Node.js, and PHP; an OpenAPI specification; and a Postman collection.
- **MCP server for AI assistants**: https://fraudcheckapi.com/mcp (Streamable HTTP) exposes every check as a tool (screen, check_ip, check_email, check_phone, check_name, geolocate, list_reason_codes). Works with any MCP-capable assistant — Claude, ChatGPT, Grok, Gemini, Cursor, and others. Authenticate with an API key in the X-Api-Key header (or as a Bearer token); calls are billed like REST calls. Server card: https://fraudcheckapi.com/.well-known/mcp/server-card.json

## Pricing
Free, Basic, Pro, and Enterprise tiers. Plans differ on volume, rate, batch, and support only — never on data quality; every tier gets the complete check set.

## Free tools (no API key required)
Full fraud screen (the composite), IP lookup, IP geolocation, email verification, phone check, and country/sanctions lookup — at https://fraudcheckapi.com/Tools

## Key pages
- Home: https://fraudcheckapi.com/
- Product: https://fraudcheckapi.com/Product
- Checks: https://fraudcheckapi.com/Checks
- Data coverage: https://fraudcheckapi.com/Data
- Built for AI (MCP): https://fraudcheckapi.com/AI
- Integrations: https://fraudcheckapi.com/Integrations
- Pricing: https://fraudcheckapi.com/Pricing
- Documentation: https://fraudcheckapi.com/Docs
- Free tools: https://fraudcheckapi.com/Tools
- Contact: https://fraudcheckapi.com/Contact
- Terms of Service: https://fraudcheckapi.com/Terms
- Privacy Policy: https://fraudcheckapi.com/Privacy