API Changelog

Stay up-to-date with the latest changes, improvements, and new features in our APIs

Version 1.4.0

December 2025

New Feature Usage Reporting API

  • GET /api/v1/reports/usage - Get usage statistics for the authenticating API key
  • GET /api/v1/reports/usage/all - Get aggregated statistics across all your API keys
  • Spam Detection Analytics: See how many spam/scam/robocall numbers detected, spam rate percentage, and breakdown by type
  • Flexible Time Ranges: Query by custom date range or use presets (today, 7d, 30d, 90d)
  • Time Series Data: Group results by day, week, or month for trending analysis
  • Product Breakdown: See usage split by LRN, CNAM, Spam, Messaging, and Trust lookups

Use Cases for Usage Reporting API:

  • Spam Detection Insights: Track how many spam numbers you're catching and identify trends
  • Cost Analysis: Monitor spending per API key and optimize usage patterns
  • Custom Dashboards: Integrate usage data into your own analytics platforms
  • Billing Reconciliation: Verify charges match your expected usage
  • Compliance Reporting: Generate audit trails for regulatory requirements

Improvements Enhanced Lookup History Dashboard

  • Stats Overview Cards: At-a-glance view of total lookups, spending, spam detected, and clean numbers
  • Date Range Filtering: Filter by custom dates or quick presets (Today, 7 Days, 30 Days, 90 Days)
  • API Key Filter: View history for specific API keys
  • Spam Type Breakdown: See detection counts by spam type (spam, scam, robocall)
  • Enhanced CSV Export: Export includes spam status and detection details

Version 1.3.0

December 2025

New Feature Bulk API Endpoints

  • /api/v1/lrn/bulk - Process up to 1,000 LRN lookups in a single request
  • /api/v1/cnam/bulk - Process up to 1,000 CNAM lookups with optional spam check
  • /api/v1/spam/batch - Process up to 100 spam reputation lookups
  • Automatic Deduplication: Duplicate phone numbers are detected and only charged once - the input_indices field shows original positions in your input array
  • Two-Phase Billing: Balance is reserved before processing and settled after completion - you're never charged for failed lookups
  • Detailed Job Tracking: Every bulk request gets a unique job_id with complete billing breakdown and timing information

New Feature LRN Activation Date - Free with Every Lookup

  • Added lrn_activated_at field to all LRN lookup responses
  • Shows when a phone number was last ported to its current carrier
  • Included at no additional cost with standard LRN lookups
  • Returned in ISO 8601 format (e.g., "2021-09-01T00:00:00+00:00")

Use Cases for LRN Activation Date:

  • Fraud Detection: Recently ported numbers may indicate SIM swap fraud or account takeover attempts
  • Lead Scoring: Number stability and age indicates legitimacy - longer tenure suggests established business or individual
  • KYC/Compliance: Verify number ownership duration as part of Know Your Customer processes
  • Risk Assessment: Flag accounts using recently ported numbers for additional verification
  • Porting Pattern Analysis: Detect suspicious porting activity across your customer base

Improvements Dashboard UX Enhancements

  • Smart Phone Normalization: Enter numbers in any format (e.g., (949) 460-0638, 949.460.0638, +1-949-460-0638) - they're automatically cleaned and validated
  • Real-Time Job Progress: Watch your bulk jobs process in real-time via Server-Sent Events - no more page refreshing
  • CSV Preview & Cost Calculator: Preview your upload and see the exact cost before processing
  • Drag-and-Drop Upload: Simply drag your CSV file onto the upload zone
  • Low Balance Warnings: Get notified before your balance runs out

Version 1.2.0

New Feature LRN-only Lookup Mode

  • Added lrn_only parameter for faster, cost-effective lookups
  • Returns only phone_number and lrn_value when enabled
  • Overrides all other lookup flags when set to true
  • Optimized for high-volume routing and basic validation use cases

When to Use LRN-only Mode:

  • Call routing and number portability checks
  • Basic phone number validation
  • High-volume processing where speed matters
  • Cost optimization for simple lookups

Breaking Change Porting History Removal

  • Removed porting_history object from all API responses
  • Removed original_carrier and has_been_ported fields
  • Updated documentation to reflect current available data
  • Existing integrations should remove references to these fields

Performance Improvements:

  • Reduced response times for LRN-only requests
  • Optimized caching for basic lookup data
  • Improved API efficiency for high-volume users

Documentation Updated API Documentation

  • Added comprehensive lrn_only parameter documentation
  • Updated response examples to reflect current data structure
  • Added "Lookup Modes" comparison table
  • Removed outdated porting history references

Version 1.1.0

New Feature Enhanced LRN Parameter Support

  • Added include_enhanced_lrn parameter for detailed carrier information
  • Enhanced response includes carrier details, location data, and messaging capabilities
  • Backward compatible with existing API calls

Improvements Response Fields

  • Added enhanced_lrn_data object with comprehensive carrier information
  • Improved data accuracy for carrier detection
  • Enhanced location data with city and state information

Performance Improvements:

  • Optimized enhanced LRN data retrieval
  • Improved caching mechanisms
  • Reduced latency for enhanced lookups

Version 1.0.0

Initial Release Core API Features

  • Phone number validation and formatting
  • Basic LRN (Local Routing Number) lookup
  • Carrier identification and network information
  • CNAM (Caller Name) lookup functionality
  • Spam and fraud detection capabilities

API Endpoints Available Endpoints

  • RESTful API with JSON responses
  • GraphQL API for flexible queries
  • Batch processing capabilities
  • Real-time lookup functionality

Security Authentication & Security

  • API key-based authentication
  • Rate limiting and usage monitoring
  • HTTPS encryption for all requests
  • Comprehensive error handling