Number Intelligence & HLR

Number lookup

Validate a phone number and resolve its destination and, for Moroccan mobiles, the serving operator — including ported numbers the platform has learned about, which prefix tables alone cannot see. Billed per successful lookup (lookup channel of your rate card, 0.05 MAD list price); an invalid number is a 400 and is never billed. Requires the send permission scope.

get/lookup/{number}

Request

  • Base URL: https://api.envoisms.ma/v1
  • URL: https://api.envoisms.ma/v1/lookup/{number}
  • Auth: HTTP bearer

Path parameters

numberstring required

The number to look up, E.164 (URL-encode the +, e.g. %2B212612345678). National Moroccan formats (06…, 07…) are accepted and normalized.

Response

Lookup result

idstring
numberstring
validboolean
country_isostring

ISO 3166-1 alpha-2 of the destination, or XX when unknown.

type'mobile' | 'unknown'
operatorstring nullable

Serving operator when known (Moroccan mobiles and major foreign prefixes), else null.

portedboolean

true when the platform has evidence the number moved to a different operator than its allocated block.

Example response

{
  "id": "lkp_1a2b3c4d5e6f",
  "number": "+212612345678",
  "country_iso": "MA",
  "operator": "Inwi"
}

Changes

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