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
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 publiccurl 'http://127.0.0.1:8080/?action=sources'
curl 'http://127.0.0.1:8080/?action=numbers&source=freephonenum.com&limit=2'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.
php tests/run.phpTests 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.