Skip to main content
The Number lookup endpoints check phone numbers against the mobile network, without sending them a message. Use them to clean a list before a broadcast, or to validate a number when someone signs up. Both paths are relative to https://api.vobiz.ai/api/v1/Account/{auth_id}/Sms.

What each result tells you

Caching and limits

  • Results are cached for 24 hours. A lookup of the same number within 24 hours reuses the earlier result. Set fresh to true to ask the network again.
  • 1,000 network lookups per account per UTC day. Cached results and inputs that can’t be read as phone numbers don’t count toward it.
  • Numbers without a country code are read using defaultCountry, which defaults to US.