Pricing

Rating

Developer

Actor stats

Categories

Share

🔗 SMS Receive Online API Actor

Retrieve active temporary phone numbers and fetch incoming SMS/OTP verification passcodes programmatically using OnlineSim's free virtual number content directory.

This Actor integrates with a high-performance Cloudflare Worker edge reverse-proxy to fetch available online countries, search active non-archived phone numbers, and retrieve text messages in real-time.

⏱️ Important: SMS Delivery Timing

After sending an SMS to a virtual number, please allow 3 to 5 minutes for the message to appear in the inbox before polling the messages action. SMS delivery through carrier networks involves routing through multiple gateways, which introduces a natural delay. Polling too early will return an empty message list.

🌟 Key Features

• Online Filtering: Stale or offline countries are automatically filtered out.
• Active-Only Inventory: Archived phone numbers are automatically cleaned from search results.
• Response Cleanup: Removes excessive root payload keys and localization properties, returning clean, light JSON.
• Verification Code Extractor: Automatic regex extraction of OTP/verification codes from incoming text bodies.
• Multi-Mode Support: Run lists for countries, numbers, or specific SMS message retrieval.

📥 Input Parameters

Input JSON Examples

1. Retrieve all countries

{
"action":"countries"
}

2. Retrieve numbers for a country

{
"action":"numbers",
"country":"united_kingdom"
}

3. Retrieve messages for a number

{
"action":"messages",
"country":"united_kingdom",
"number":"447348624600"
}

⏱️ Note: Wait 3–5 minutes after sending an SMS before using the messages action.

📤 Output Data Structure

The dataset returns cleaned, structured tables depending on the selected action:

Output JSON Example - countries

[
{
"action":"countries",
"country":44,
"name":"united_kingdom"
},
{
"action":"countries",
"country":30,
"name":"greece"
}
]

Output JSON Example - numbers

[
{
"action":"numbers",
"country":"united_kingdom",
"full_number":"447348624600"
}
]

Output JSON Example - messages

[
{
"action":"messages",
"country":"united_kingdom",
"number":"447348624600",
"id":21694442,
"text":"Vonage code: 7018. Valid for 3 minutes.",
"in_number":"Vonage",
"my_number":7348624600,
"created_at":"2026-06-05 23:14:09",
"data_humans":"11 seconds ago",
"code":"7018"
}
]