API FAQ

You can generate API keys from your dashboard after creating an account.

We support E.164 format (+15555550123) and national formats (555-555-0123).

Yes, free accounts have 100 requests/hour, paid accounts have 1000 requests/hour.

We support Bearer token authentication. Include your API key in the Authorization header as "Bearer YOUR_API_KEY".

Implement exponential backoff when you receive a 429 status code. Check the retry_after header for the recommended wait time.

We accept E.164 format (+15555550123) and 10-digit US format (5555550123). International numbers should use E.164 format.

Our data update frequency varies by product type:

• LRN/Carrier Data: Real-time updates via direct carrier connections and industry databases
• CNAM (Caller ID): Updates within 24-48 hours from carrier databases
• Spam Reputation: Continuously updated from multiple sources including user reports, carrier data, and industry databases
• Messaging Provider: Real-time lookups with cached data refreshed every 24 hours

Yes, we provide comprehensive coverage for both United States and Canadian phone numbers. Our data sources include:

• Major Carrier Databases: Partnerships with tier-1 carriers in both countries for accurate LRN and porting data
• Industry Databases: Access to FCC, CRTC, and industry spam/fraud reporting databases

Our APIs support all NANP (North American Numbering Plan) numbers including toll-free, mobile, and landline numbers in both countries.

We aggregate data from multiple authoritative sources to ensure accuracy:

• Direct carrier partnerships with major US and Canadian telcos
• LIDB (Line Information Database) for CNAM information
• Industry consortium data for spam and fraud detection
• Proprietary algorithms combining multiple data points for enhanced accuracy

You have two options for accessing your usage analytics:

• Dashboard: Visit My Lookup History to see detailed analytics including total lookups, spending, spam detection rates, and spam type breakdown. Filter by date range, API key, and export to CSV.
• Reporting API: Use GET /api/v1/reports/usage for programmatic access to the same statistics. Perfect for integrating analytics into your own dashboards.

The Reporting API provides comprehensive usage statistics via a simple GET request:

GET /api/v1/reports/usage?start_date=2024-01-01&end_date=2024-01-31&group_by=day
Authorization: Bearer YOUR_API_KEY

The response includes:

• Total lookups and spending for the period
• Spam detection counts (spam detected vs clean numbers)
• Spam rate percentage and breakdown by type (spam, scam, robocall)
• Usage breakdown by product type (LRN, CNAM, Spam, etc.)
• Time series data for trending analysis

Use /api/v1/reports/usage/all to get aggregated stats across all your API keys.

Yes! Both the dashboard and API support filtering by API key:

• Dashboard: Use the "API Key" dropdown in the filter bar on the Lookup History page
• API: The /api/v1/reports/usage endpoint automatically filters to the API key used for authentication. Use /api/v1/reports/usage/all for combined stats across all keys.

Usage is billed per successful API call. Check your dashboard for current pricing and usage statistics.

Yes, we offer a free tier with limited monthly requests. Upgrade to a paid plan for higher limits and additional features.

Contact our support team at support@verirouteintel.com or through your dashboard. We provide documentation, code examples, and direct assistance.