API Changelog

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

Version 1.6.0

January 2026

New Feature Interactive API Explorer

  • /api-docs/explorer - New Swagger UI-powered interactive console
  • Try any endpoint directly in your browser with live responses
  • Built-in authentication - enter your API key once to test all endpoints
  • Auto-generated from OpenAPI specification for accuracy

New Feature API Quick Reference Page

  • /api-docs/quick-reference - All endpoints at a glance
  • Complete endpoint table with rate limits and auth requirements
  • Quick navigation by category: Core Lookups, Bulk, Spam, Reports, Utility

Documentation OpenAPI Specification Expansion

  • Added 14 missing endpoints to OpenAPI spec (now 100% coverage)
  • New endpoints documented: /api/v1/spam, /api/v1/spam/batch, /api/v1/spam/report, /api/v1/spam/report/public, /api/v1/spam/lookup/enhanced
  • Reports endpoints: /api/v1/reports/usage, /api/v1/reports/usage/all, /api/v1/reports/export, /api/v1/analytics
  • Utility endpoints: /api/v1/health, /api/v1/pricing/all, /api/v1/auth/validate-key
  • Added missing LRN parameters: lrn_only, include_enhanced_lrn, messaging_lookup
  • Corrected rate limits to match actual implementation

Documentation Spam API Documentation Expansion

  • Expanded to cover all 5 spam endpoints with full examples
  • Added Basic Spam Lookup (GET/POST) documentation
  • Added Enhanced Multi-Source Lookup with confidence scores
  • Improved Batch Spam Lookup docs with deduplication explanation

Documentation Trust API v2 Visibility Improvements

  • Added "Choose Your Version" quick-select at top of Trust API docs
  • v2 now prominently featured with "RECOMMENDED" badge
  • Improved navigation with direct jump links to v2 section

Documentation Error Handling Guide Enhancements

  • Added comprehensive Error Code Glossary with all codes
  • Documented both response formats (data/errors envelope vs standard error)
  • Added resolution suggestions for each error code

Version 1.5.0

January 2026

New Feature Trust API v2 with Reputation Scoring

  • POST /api/v2/trust - Enhanced trust endpoint with quantitative reputation scoring
  • reputation_score: 0-100 integer (higher = more trustworthy). Scam=10, Robocall=20, Spam=35, Clean=50-85
  • trust_level: Categorical level - "high" (70+), "medium" (40-69), "low" (<40)
  • last_updated: ISO 8601 timestamp showing when data was last updated
  • Backward Compatible: v1 endpoint (/api/v1/trust) remains unchanged for existing integrations

New Feature LRN API with Optional CNAM and Trust Includes

  • include_cnam: Add include_cnam=true to get caller name data in your LRN response
  • include_trust: Add include_trust=true to get trust/reputation data with reputation_score and trust_level
  • Single Request: Get LRN, CNAM, and Trust data in one API call instead of three
  • Billing: Each included product is billed separately (LRN + CNAM + Trust)
  • Available on both single (/api/v1/lrn) and bulk (/api/v1/lrn/bulk) endpoints

Use Cases for Combined LRN Lookups:

  • Lead Verification: Get carrier info, caller name, and spam status in one call for complete lead qualification
  • Call Center Optimization: Screen inbound calls with combined trust and CNAM data before routing
  • KYC/Compliance: Verify phone ownership with carrier data plus caller identity and reputation
  • Fraud Prevention: Combine LRN porting history with spam reputation for risk scoring

Improvements GraphQL Schema Updates

  • Added CnamData type with caller_name field
  • Added TrustData type with reputation_score, trust_level, last_updated
  • Added TrustResultV2 type for v2 trust queries
  • Updated lookupLrn query with includeCnam and includeTrust parameters
  • Added lookupTrustV2 query for reputation scoring

Documentation Updated API Documentation

  • Updated LRN API docs with new include parameters and response examples
  • Added Trust API v2 section with reputation scoring documentation
  • Updated OpenAPI schema with new endpoints and schemas
  • Added code examples for combined lookups in Python, cURL, and GraphQL

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