Changelog

• Node.js SDK and CLI: npm install mobilevalidate, or npx mobilevalidate check +447700900001 --sandbox with no install. See SDKs and the CLI.
• Python SDK: pip install mobilevalidate-sdk (import mobilevalidate), sync and async clients. See SDKs.
• MCP server: npx -y @mobilevalidate/mcp runs the same tools as the hosted server over stdio. See MCP.
• Job result downloads stream CSV or NDJSON in both SDKs and the CLI (jobs download), and job estimates now return the same maximum cost that the job reserves.

• Live API console on the home page and in the docs: pick a test value, run a real request and see the response, an explained verdict and the same call in seven languages.
• Sandbox key in the docs: every example works as pasted with a public sandbox key that only accepts test values. Never billed.
• Instant test key: get a personal test key in a minute, shown once on screen, without waiting for approval. Live keys still need an approved request.
• Error suggestions: errors can include error.suggestion, a short hint on how to fix the request (for example a missing country code). Unknown endpoints now return 404 not_found with the closest match.
• Interactive API reference generated from OpenAPI 1.0.0, plus request collections for Postman, Bruno and .http files.
• Code examples in cURL, Node.js, fetch, Python, PHP, Go and Ruby, with syntax highlighting and copy buttons; recipes for common integrations.
• Python SDK and an updated Node.js SDK and CLI (retries, typed errors, sandbox mode): coming soon on PyPI and npm.
• Status page with 90-day uptime per component, this changelog with an RSS feed, and a versioning and deprecation policy.

• mobilevalidate.com is public, with live pricing and a page for every check.
• Developer documentation: quickstart, authentication, lookups, e-mail checks, bulk jobs, webhooks, errors, limits, SDK, CLI and MCP.
• The OpenAPI specification is published at /openapi.yaml, and the error catalog at /errors.json.
• Every documentation page has a Markdown version (add .md to the URL), and /llms.txt lists them for AI tools.
• The remote MCP endpoint is https://mcp.mobilevalidate.com/mcp.

• Spam reputation (number.spam) for US, Canadian and German numbers: a risk level, a 0–100 score and the reasons behind them. Limited access: available to approved customers on request. MCP tool: check_spam_reputation.
• Carrier lookup (network.carrier, beta): line type, current carrier, original carrier and country. The US/CA carrier lookup (network.carrier_us) runs in bulk jobs.
• Live network status (number.hlr) is listed as coming soon.

• A lookup may contain up to 2,000 checks and a job up to 100,000 checks (identifiers × checks). Larger requests get 400 invalid_request with a clear message before anything is processed or charged.
• Sequential number ranges and generated e-mail lists are rejected with suspected_enumeration. Checking lists of your own customers or sign-ups is unaffected.

See rate limits and abuse protection and the error reference.

• New emails field on POST /v1/lookup and POST /v1/jobs, alongside numbers.
• Mailbox validation (email.valid) and account checks by e-mail for major mail providers and consumer services. Some run in real time, others in bulk jobs only; GET /v1/services shows which.
• Result rows carry kind, email and email_status. Bulk CSV uploads accept an email column.
• Test mode includes test addresses on a reserved test domain.
• MCP server: new lookup_emails tool.

See e-mail checks.

• Catalog: messaging apps (WhatsApp, WhatsApp Business, Telegram, Viber, Signal, iMessage, RCS, LINE, Zalo, Botim, MAX, Messenger), social networks and consumer app accounts. The services reference lists every code and alias.
• Multi-check requests: up to 20 checks per request. Each identifier gets one result per service in a checks map, plus a summary.by_service count. The original whatsapp object is kept for compatibility.
• GET /v1/services returns the catalog your key can use, including each attribute's type (string, boolean or integer).
• SDK, CLI and MCP server: services / list_services and the checks option.

The MobileValidate API is available at https://api.mobilevalidate.com/v1 for approved customers.

• Real-time lookups with POST /v1/lookup: send up to 100 phone numbers and get one result per number, with registered, status and checked_at.
• Bulk jobs with POST /v1/jobs for lists, with paginated results and CSV or NDJSON downloads.
• Test mode: mv_test_… keys return fixed answers for the test numbers, are never billed and never reach a real network.
• Webhooks for finished lookups and jobs, with endpoint verification and Standard Webhooks signatures. See webhooks.
• Idempotency keys on every POST: a retry with the same key and body within 24 hours replays the first response instead of checking again.
• Fair billing: inconclusive results (unknown, unsupported country, timeout, invalid, duplicate) are never charged.
• TypeScript SDK and CLI (mobilevalidate). The npm release is coming soon.