Does it work with dual-SIM phones?

Yes. On dual-SIM phones one radio receives SMS for both numbers. The push API first authenticates the atsms_ token, then matches the device number on the last 7 digits, so both SIMs work without false rejections.

Can the same phone number be registered by multiple accounts?

Yes. Phone numbers are not exclusive — each registration gets its own atsms_ key with its own rolling 10-SMS storage, and pushes are authenticated by the token, not by number ownership. Re-adding a number you already have simply returns your existing key.

How do I read a received verification code?

One curl command: curl -s -H 'Authorization: Bearer atsms_XXX' 'https://aitun.cc/aitun-api/sms/recent?n=20' returns the latest SMS senders and snippets (each message tagged with the phone number it arrived on — dual-SIM: latest 10 per number); the full text of one message is at /aitun-api/sms/message/{ID}.

How many phone numbers do I get for free?

Every account gets 5 SMS phones free (plus 5 subdomains and 5 receive-only Agent Email mailboxes). Extra phone slots cost $1.00 each via PayPal.

Agent SMS — Receive SMS Verification Codes for AI Agents

Q: Is Agent SMS a virtual number rental?

No. The phone number stays yours — it is the real SIM in your own Android phone. The open-source aitunSMS app pushes only what the SIM actually receives, and you can rotate or revoke the atsms_ key anytime.

Q: How many SMS are stored per phone number?

Only the latest 10 SMS are kept per phone (text only). Older messages roll off automatically. Every message is fingerprinted on arrival so the app can re-push safely without duplicates.

📱

Agent SMS — Receive-Code Phones for AI Agents

Give your AI agent a phone number it can actually read. Create an atsms_ token with one click, install the aitunSMS Android app on the phone, and every incoming SMS verification code is pushed to aitun.cc automatically — numbers auto-classified from the pushes, rolling 10-message window per number, retrievable through a one-command API with an atsms_ key.

🔒 Sign-in required — you'll be prompted automatically. A token learns up to 2 phone numbers automatically from the app's pushes (dual-SIM). Free: 5 subdomains · 5 mailboxes · 5 SMS tokens (extra tokens $1 each).

🏃

Verification-Code Ready

Sign-up flows that require a phone number become agent-friendly: the SMS arrives on your phone and becomes readable via API within seconds. Codes stay machine-readable text — no screenshots needed.

📱

Your Own Real SIM

This is not a virtual-number rental. The phone number stays yours — the open-source aitunSMS app pushes only what the SIM actually receives, and you can rotate or revoke the atsms_ key anytime.

🤖

Zero-Typing, Auto-Classified

No phone numbers to type. The app tags every pushed SMS with the SIM it arrived on, and the server classifies the numbers automatically — a token learns its dual-SIM pair (max 2 numbers) on the first pushes.

🤖

One-Command Agent API

Each token has one atsms_ key covering its numbers. One curl command returns the latest 20 texts (latest 10 per number on dual-SIM, each tagged with its number) — perfect for AI agents fetching verification codes mid-signup.

🔒

Rolling 10-SMS Window

Only the latest 10 SMS are kept per phone — older ones roll off automatically. Every message is fingerprinted on arrival (phone + timestamp + sender + body) so the APK can re-push safely without duplicates.

🏆

Simple Quota

Every account gets 5 SMS tokens free (plus 5 subdomains and 5 mailboxes); each token covers one phone (dual-SIM = both numbers). Need more? Extra tokens are $1.00 each — buy instantly via PayPal from your dashboard.

Agent SMS Quick Start

Three steps and you're live: click Add to create a token, install the Android app, paste the key — phone numbers are learned automatically from the app's pushes, then your AI agent reads received verification codes with one command.

Sign in & click Add

Agent SMS page on aitun.cc — click the Add button to create a new SMS token

Open the Agent SMS page on this site and click Add — a new atsms_ token is created instantly, no phone number to type (numbers are auto-classified from the app's pushes). Registration requires sign-in — you'll be prompted automatically. Free: 5 tokens per account.

Copy the atsms_ key

aitun.cc Console SMS tab — the token list showing the masked atsms_ token with Copy and Copy for Agent buttons

Add jumps you straight to Console → SMS where the new token is listed. Click 📋 Copy next to the key for the bare token — this is what the app and the API use — or 📋 Copy for Agent to also get ready-to-paste API commands for your AI agent. You can regenerate it anytime.

Install aitunSMS on the phone

⬇️ Download aitunSMS.apk QR code — scan it with the Android phone to download aitunSMS.apk directly

Scan the QR with the phone that owns the SIM, or open https://aitun.cc/downloads/aitunSMS.apk in its browser. Requires Android 8.0+; grant SMS & notification permissions on first launch.

Paste the key & press START

aitunSMS Android app — paste the atsms_ key into the token field at the top and press the green START button

Open aitunSMS on the phone, paste the atsms_ key into the token field and press ▶ START. Incoming SMS are pushed automatically — the server auto-classifies the SIM numbers (dual-SIM = 2 numbers under the token), deduplicates, rolling 10-message storage.

Done — now your AI agent reads received verification codes with one command:

# Latest 20 SMS (senders + snippets) — ONE command, no login needed
curl -s -H "Authorization: Bearer atsms_XXX" "https://aitun.cc/aitun-api/sms/recent?n=20"

# Read the full text of one SMS
curl -s -H "Authorization: Bearer atsms_XXX" "https://aitun.cc/aitun-api/sms/message/{SMS_ID}"
            

⬇️ Download aitunSMS.apk (Android) Requires Android 8.0+ · SMS & notification permissions requested on first launch · MIUI/HyperOS: also set 其他权限 → 通知类短信 → 始终允许 (the app shows a hint if this is missing)