Changelog

API updates, new features, and improvements

Stay up to date with the latest changes to the telco.dev API.

January 2025

January 15, 2025

New Features

• Added per-minute rate limiting for better burst protection
• Query parameter support for all endpoints (e.g., /v1/lookup?tn=...)
• Improved error messages with specific guidance

Improvements

• Enhanced error responses with details object for rate limits
• Better validation messages for invalid parameters

January 10, 2025

Improvements

• Updated NANPA and CNAC data sources
• Performance improvements for search queries
• Added last_updated field to lookup responses

January 1, 2025

Initial Release

• Phone number lookup (/v1/lookup/:tn)
• Area code lookup (/v1/npa/:npa)
• NPA-NXX specific lookup (/v1/npa/:npa/nxx/:nxx)
• Search endpoint (/v1/search)
• Carrier list and details (/v1/carriers, /v1/carrier/:ocn)
• Health and stats endpoints
• API key authentication
• Rate limiting by tier

Data Updates

Our database is updated daily from official sources:

Check /v1/stats to see the latest ingestion timestamps.

Upcoming

We're working on:

• Bulk lookup endpoint
• Webhook notifications for number changes
• Historical data access
• Enhanced carrier type detection

Have a feature request? Let us know.