Phone Verification

Use the phone verification tools only when a target flow requires an SMS code.

Workflow

1. Start with free public numbers:
   • list_free_phone_numbers(country="all")
   • Use a relevant country filter when the target requires it.
2. Submit the selected number in the target flow.
3. Read the inbox:
   • read_phone_inbox(phone_number="...")
   • Use sender_filter when the inbox is noisy.
4. If the target blocks public numbers, use a private-number provider:
   • Retrieve the provider API key with get_credential.
   • request_private_number(...)
   • poll_private_number(...)

Rules