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

requis

String array of numbers

Exemples


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

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


<?xml version="1.0" encoding="UTF-8"?>
<lookup>
  <to>33612345678</to>
  <to>33612345677</to>
</lookup>

Format de la réponse


{
  "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
        }
      }
    ]
  }
}


<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>1</status>
  <message>OK</message>
  <cost>2</cost>
  <credits>25</credits>
  <response>
    <lookup>
      <to>33612345678</to>
      <mccMnc>20801</mccMnc>
      <originalNetwork>
          <networkName>Orange</networkName>
          <networkPrefix>671</networkPrefix>
          <countryName>France</countryName>
          <countryPrefix>33</countryPrefix>
      </originalNetwork>
      <ported>false</ported>
      <roaming>false</roaming>
      <status>
          <name>UNDELIVERABLE</name>
          <description>Message sent not delivered</description>
          <detailed>UNDELIVERABLE_NOT_DELIVERED</detailed>
      </status>
      <error>
          <id>27</id>
          <description>Absent Subscriber</description>
          <permanent>false</permanent>
      </error>
    </lookup>
    <lookup>
      <to>33612345677</to>
      <mccMnc>20801</mccMnc>
      <imsi>208019900000000</imsi>
      <originalNetwork>
          <networkName>Orange</networkName>
          <networkPrefix>671</networkPrefix>
          <countryName>France</countryName>
          <countryPrefix>33</countryPrefix>
      </originalNetwork>
      <ported>false</ported>
      <roaming>false</roaming>
      <status>
          <name>DELIVERED</name>
          <description>Message delivered to handset</description>
          <detailed>DELIVERED_TO_HANDSET</detailed>
      </status>
      <error>
          <id>0</id>
          <description>No Error</description>
          <permanent>false</permanent>
      </error>
    </lookup>
  </response>
</response>