Skip to main content
POST
sms.number.search

Authorizations

Authorization
string
header
required

A Lath API key: lath_live_sk… or lath_test_sk… on a server, lath_live_pk… or lath_test_pk… in a browser.

Body

application/json
country
enum<string>
default:US

Country to search. Local numbers in the US and Canada are covered by the carrier registration this product files.

Available options:
US,
CA
areaCode
string
Pattern: ^[2-9]\d{2}$
contains
string

Digits (or letters, spelled on a keypad) the number must contain, e.g. 555 or LATH.

Pattern: ^[0-9A-Za-z*]{2,10}$
limit
integer
default:10
Required range: 1 <= x <= 20

Response

{ activityId, result }. activityId is empty for reads.

activityId
string
required

The activity this call created, or empty for a read.

result
object
required
Last modified on September 16, 2026