SMS

Look up carrier + line type

Changed on

Carrier name and line type (mobile / landline / voip / toll-free) for a number, plus smsReachable. Use it to validate recipients before sending. Each lookup is billed by the carrier-data provider, so call it explicitly (e.g. pre-validating an opt-in list), not on every send.

get/v1/sms/lookup

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/sms/lookup
  • Auth: HTTP bearer

Query parameters

numberstring required

Number to look up (E.164; formatting is normalized).

Response

Lookup result. An unknown/invalid number returns lineType unknown with smsReachable false rather than an error.

phoneNumberstring
carrierNamestring nullable
lineType'mobile' | 'landline' | 'voip' | 'toll-free' | 'unknown'
smsReachableboolean

False for landlines, toll-free numbers, ambiguous fixed-or-mobile lines and carriers whose numbers are not SMS-routable. True is a best guess, not a delivery guarantee.

Changes

  • f8c8f34fb41aRevision changes
    • warning

      added the new account enum value to the / response property for the response status

  • d556591af3f6Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status