HLR Lookup

Mit dem HLR-Lookup können Sie Informationen über eine Handynummer abrufen, wie z. B. ihre Gültigkeit, ob sie gerade aktiv ist oder ihr Netz. Sie können auch herausfinden, ob sich die Nummer im Roaming-Modus befindet, oder ob sie an einen anderen Netzwerkanbieter gerichtet ist.

POST

/lookup

Body-Parameter

to
notwendig
 Dieses Feld muss ein Array von Telefonnummern sein

Beispiele


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>

Ergebnisformat


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