HLR Lookup

Le HLR lookup vous permet de récupérer des informations sur un numéro mobile comme sa validité, s'il est actuellement actif ou encore son réseau. Vous pouvez également savoir si le numéro est en mode roaming, ou encore s'il est porté vers un autre opérateur.

POST

/lookup

Paramètres du body

to
requis
Ce champ doit être un tableau de numéros de téléphone

Exemples

JSON
POST /lookup HTTP/1.1
Host: api.smsfactor.com
Authorization: Bearer your.token
Accept: application/json

{
  "lookup": {
    "to": ["33612345678", "33612345677"]
  }
}
        

Format de la réponse

JSON
{
  "status": 1,
  "message": "OK",
  "cost": 2,
  "credits": 642,
  "response": {
    "lookup": [
      {
        "to": "33612345678",
        "mccMnc": "20801",
        "imsi": "208019900000000",
        "originalNetwork": {
          "networkName": "Orange",
          "networkPrefix": "671",
          "countryName": "France",
          "countryPrefix": "33"
        },
        "ported": false,
        "roaming": false,
        "status": {
          "name": "DELIVERED",
          "description": "Message delivered to handset",
          "detailed": "DELIVERED_TO_HANDSET"
        },
        "error": {
          "id": 0,
          "description": "No Error",
          "permanent": false
        }
      },
      {
        "to": "33612345677",
        "mccMnc": "20801",
        "originalNetwork": {
          "networkName": "Orange",
          "networkPrefix": "671",
          "countryName": "France",
          "countryPrefix": "33"
        },
        "ported": false,
        "roaming": false,
        "status": {
          "name": "UNDELIVERABLE",
          "description": "Message sent not delivered",
          "detailed": "UNDELIVERABLE_NOT_DELIVERED"
        },
        "error": {
          "id": 27,
          "description": "Absent Subscriber",
          "permanent": false
        }
      }
    ]
  }
}