Complete Phone Fraud Prevention Guide

// Bulk phone verification example
const phones = [
  '+1-555-123-4567',
  '+1-800-555-0199',
  '+1-555-000-0000'
];

const response = await fetch('https://api.ip-info.app/v1-bulk-validate', {
  method: 'POST',
  headers: {
    'accept': 'application/json',
    'x-api-key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    phones: phones,
    include_risk_score: true,
    webhook_url: 'https://your-app.com/webhook' // Optional
  })
});

const result = await response.json();
// {
//   "job_id": "bulk_123456",
//   "total_phones": 3,
//   "estimated_completion": "2024-01-15T10:30:00Z",
//   "status": "processing"
// }

// Check job status
const statusResponse = await fetch(
  `https://api.ip-info.app/v1-bulk-status/${result.job_id}`,
  {
    headers: {
      'accept': 'application/json',
      'x-api-key': 'YOUR_API_KEY'
    }
  }
);

const status = await statusResponse.json();
// {
//   "job_id": "bulk_123456",
//   "status": "completed",
//   "progress": 100,
//   "results": [
//     { "phone": "+1-555-123-4567", "valid": true, "carrier": "Verizon", "risk_score": 15 },
//     { "phone": "+1-800-555-0199", "valid": true, "carrier": "Toll Free", "risk_score": 25 },
//     { "phone": "+1-555-000-0000", "valid": false, "carrier": null, "risk_score": 95 }
//   ]
// }

async function verifyPhoneWithRetry(phone, maxRetries = 3) {
  for (let attempt = 1; attempt <= maxRetries; attempt++) {
    try {
      const response = await fetch(`https://api.ip-info.app/v1-get-phone-details?phone=${phone}`, {
        method: 'GET',
        headers: {
          'accept': 'application/json',
          'x-api-key': 'YOUR_API_KEY'
        })
      });

      if (!response.ok) {
        if (response.status === 429) {
          // Rate limited - exponential backoff
          const delay = Math.pow(2, attempt) * 1000;
          await new Promise(resolve => setTimeout(resolve, delay));
          continue;
        }

        if (response.status >= 500) {
          // Server error - retry
          if (attempt < maxRetries) continue;
        }

        throw new Error(`HTTP ${response.status}: ${response.statusText}`);
      }

      const result = await response.json();

      // Handle different risk scores
      if (result.risk_score <= 30) {
        return { ...result, status: 'safe' };
      } else if (result.risk_score <= 70) {
        return { ...result, status: 'review' };
      } else {
        return { ...result, status: 'block' };
      }

    } catch (error) {
      console.error(`Attempt ${attempt} failed:`, error.message);

      if (attempt === maxRetries) {
        return {
          phone,
          valid: false,
          error: error.message,
          status: 'error'
        };
      }

      // Wait before retry
      await new Promise(resolve => setTimeout(resolve, 1000 * attempt));
    }
  }
}