YourSendYourSend
Sign InGet Started →

GET /v1/lookup/:phone

Look up carrier and country information for a phone number.

Phone Lookup

Returns carrier name, carrier type (mobile, landline, voip), and country code for any phone number in E.164 format. Useful for determining the best channel before sending, or validating phone numbers.

Path Parameters

ParameterTypeDescription
phonestringPhone number in E.164 format (e.g. +14155551234)

Response

Response
{
  "phone_number": "+14155551234",
  "country_code": "US",
  "carrier": "T-Mobile USA, Inc.",
  "type": "mobile"
}

Example

cURL
curl https://api.yoursend.dev/v1/lookup/%2B14155551234 \
  -H "Authorization: Bearer ys_live_..."

Note: The + must be URL-encoded as %2B in the URL path.