latestOpenAPI 3.0.0MIT2026-08-1011315.3 KB

2117f1876b2a

NumberLookup

Performs a number lookup.

post/v1/lookups

Request body

numberstring required

MSISDN in E.164 format to query.

featuresApiFeature[]

Contains requested features. Fallback to LineType if not provided.

Example request

{
  "number": "+12312312312"
}

Response

Successful response

countryCodestring

ISO 3166-1 alpha-2 two-letter country identifier

traceIdstring

The identifier for a trace.

numberstring

Requested MSISDN in E.164 format.

Example response

{
  "line": {
    "carrier": "T-Mobile USA",
    "mobileCountryCode": "310",
    "mobileNetworkCode": "260",
    "ported": true,
    "portingDate": "2000-01-01 00:00:00+00:00"
  },
  "simSwap": {
    "swapped": true
  },
  "traceId": "84c1fd4063c38d9f3900d06e56542d48",
  "number": "+12312312312"
}