{
  "schema_version": "v1",
  "name": "SimSMS",
  "description": "Anonymous virtual phone numbers for AI agents — both single-use SMS verification ($0.20-$1, 20 min validity) AND long-term dedicated rental (7/14/30/90 days, $3-$30, unlimited incoming SMS). 1000+ services (Google, Telegram, WhatsApp, Discord, Tinder, Uber, Binance, OpenAI, Twitter/X, etc.) in 190+ countries. Agents purchase end-to-end via REST API or MCP server. No KYC, crypto-only, instant delivery.",
  "url": "https://simsms.co",
  "logo": "https://simsms.co/og-image.svg",
  "openapi_url": "https://simsms.co/openapi.json",
  "mcp_url": "https://simsms.co/mcp",
  "agent_recipe_url": "https://simsms.co/agents",
  "llms_txt_url": "https://simsms.co/llms.txt",
  "x402_supported": true,
  "x402_mode": "exact",
  "x402_network": "base",
  "x402_assets": ["USDC"],
  "x402_note": "Real x402 (scheme 'exact') on Base in USDC, for /api/v1/topup only (NOT /numbers — your balance covers many SMS). POST /api/v1/topup with header 'X-Payment-Mode: x402' to receive a standard HTTP 402 whose body carries an x402 'accepts' block. Sign the EIP-3009 USDC authorization and re-send the same request with the 'X-PAYMENT' header; our facilitator settles it on-chain (gasless for you) and the top-up is credited after settlement.",
  "auth": {
    "type": "bearer",
    "token_format": "AAAA-BBBB-CCCC-DDDD (mixed-case, 19 chars including dashes)",
    "creation_endpoint": "https://simsms.co/api/v1/account",
    "auto_create_on_topup": false,
    "kyc_required": false,
    "email_required": false,
    "note": "POST /api/v1/account creates a free account and returns the seed. Account starts at $0 — fund it via POST /api/v1/topup (min $25) before buying numbers. Store the seed; it is the only credential."
  },
  "payment": {
    "currencies": ["BTC","XMR","ETH","USDT","USDCETH","XRP","LTC","SOL","TRX","TON","DOGE","POL","BCH","DASH"],
    "fiat_supported": false,
    "settlement_provider": "per-order deposit addresses (any-coin checkout)"
  },
  "business_rules": {
    "account_creation_fee_usd": 0,
    "account_creation_note": "Account creation is free. The balance starts at $0 and is funded by topups; you spend out of the balance per SMS verification or per rental.",
    "topup_min_usd": 25.0,
    "topup_max_usd": 1000.0,
    "rate_limits": {
      "api_account_per_minute_per_ip": 4,
      "api_topup_per_minute_per_ip": 6,
      "api_number_per_minute_per_ip": 12
    }
  },
  "products": [
    {
      "id": "sms_verify",
      "name": "Single-use SMS verification",
      "description": "One phone number, one SMS code. Use for account signups, OTP verification, registration. Active for 20 minutes. Refundable if no SMS arrives. Price varies $0.20-$1 by service+country.",
      "price_from_usd": 0.20,
      "price_to_usd": 1.00,
      "buy_endpoint": "POST https://simsms.co/api/v1/numbers",
      "mcp_tool": "buy_number"
    },
    {
      "id": "rental",
      "name": "Long-term virtual phone number rental",
      "description": "Dedicated number rented for 7, 14, 30 or 90 days. Receives UNLIMITED incoming SMS from any service during the rental window. Ideal for accounts an agent intends to keep using (Telegram, WhatsApp, recovery numbers, multi-factor auth) and for fleet rotation across multiple ad/marketing accounts.",
      "price_from_usd": 3.00,
      "price_to_usd": 30.00,
      "duration_options_days": [7, 14, 30, 90],
      "buy_endpoint": "POST https://simsms.co/api.php?action=rental_buy",
      "buy_endpoint_note": "Dedicated /api/v1/rentals is on the roadmap; legacy endpoint accepts same Bearer auth.",
      "mcp_tool": "(coming) rent_number — for now use cookie-auth /api.php?action=rental_buy"
    }
  ],
  "supported_services_examples": [
    "Google", "Telegram", "WhatsApp", "Discord", "Tinder", "Uber", "Binance",
    "Twitter/X", "Facebook", "Instagram", "TikTok", "OpenAI", "ChatGPT",
    "Amazon", "Apple", "Microsoft", "Steam", "PayPal", "Coinbase", "Kraken",
    "Airbnb", "Bumble", "Snapchat", "Signal", "WeChat", "LINE",
    "Yahoo", "Yandex", "Spotify", "Netflix", "and 970+ more"
  ],
  "supported_services_count": "1000+",
  "supported_countries_count": "190+",
  "test_mode": {
    "supported": true,
    "trigger": "Header X-Dry-Run: 1, query ?dry_run=1, or body field dry_run=true on any /api/v1/* endpoint",
    "behavior": "Synthetic flow with fake addresses, fake phone numbers, fake SMS codes. Topup auto-confirms after 60 s. Number auto-receives '123456' SMS after 30 s. No external provider call, no DB writes to topups/orders, no balance change."
  }
}