Phone

Mobile number portability lookup

Returns the network a number has been ported to, rather than the network its prefix implies. Costs 3 credits; a lookup that errors costs nothing.

post/mnp-lookup

Request

  • Base URL: https://app.1lookup.io/api/v1
  • URL: https://app.1lookup.io/api/v1/mnp-lookup
  • Auth: HTTP bearer

Request body

phone_numberstring required

Mobile number in E.164 format.

bypass_cacheboolean

Skip the 7-day result cache and run a fresh lookup. Also accepted as bypassCache or forceFresh, in the body or the query string. A cached result you ran yourself is free; a fresh lookup is charged as usual.

Example request

{
  "phone_number": "+447700900123"
}

Response

Lookup completed. metadata.credits_used says what it cost.

successtrue required

Changes

No recorded changes to this operation across all 1 revision of this API.