Skip to content

About

Fetch free US phone number and their lastest SMS verification code (OTP)

Resources

Contributing

Stars

10 stars

Watchers

0 watching

Forks

Repository files navigation

Free SMS API

A dependency-free PHP API for reading public US SMS inboxes through a common JSON interface. Includes number discovery, message parsing and heuristic code extraction.

API reference · Source status · Deployment · Contributing

Quick start

Requires PHP 8.1+ with curl, dom and mbstring. Composer is optional.

git clone https://github.com/iMumd/free-sms-api.git
cd free-sms-api
php -S 127.0.0.1:8080 -t public
curl 'http://127.0.0.1:8080/?action=sources'
curl 'http://127.0.0.1:8080/?action=numbers&source=freephonenum.com&limit=2'

Availability

freephonenum.com is the only included source. On 2026-10-31, direct PHP HTTPS checks fetched its listing and read messages from two inboxes. Blocked and unverified providers have been removed, not left registered. See the verification record for scope and limitations.

This project reads shared public inboxes; it does not send SMS, own the numbers or guarantee delivery, freshness or third-party acceptance. Never use public inboxes for sensitive accounts. Respect source terms, crawler policies and applicable law.

Development

php tests/run.php

Tests use offline fixtures and a local HTTP server. Contributions are welcome, especially reproducible source fixes and synthetic parser tests. Read the contribution guide before adding an integration.

Contact

GitHub · hi@mumd.dev · Telegram

License

MIT

About

Fetch free US phone number and their lastest SMS verification code (OTP)

Resources

Contributing

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages