🔗 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

Field	Type	Description	Prefill Example
Action	string (enum)	The operation to perform: countries, numbers, or messages	countries
Country	string	Normalized country slug name (required for numbers and messages)	united_kingdom
Number	string	Full virtual phone number (required for messages)	447348624600

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"
  }
]