Rufnummer API

Ersetzen Sie die Variable {number} mit einer Rufnummer im E.164 Format, jedoch ohne vorangestelltes "+".

Kompaktansicht

/number/{number}

Liefert eine kompakte Ansicht zu einer Rufnummer, deren Bestandteile mit scope bestimmt werden können.

Pfad-Variablen

number

GET /number/4917345937329 HTTP/1.1
Host: rueckwaertssuche.net
X-Api-Key: {$YOUR_API_KEY}
Accept: application/json

curl -L \
  --url 'https://rueckwaertssuche.net/number/4917345937329' \
  --header 'X-Api-Key: {$YOUR_API_KEY}'

const response = await fetch('https://rueckwaertssuche.net/number/4917345937329', {
    method: "POST",
    headers: {
        "X-Api-Key": "{$YOUR_API_KEY}",
        "Accept": "application/json"
    },
});

const data = await response.json();

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://rueckwaertssuche.net/number/4917345937329",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'app_name' => '',
    'enable_subdomains' => null,
    'network' => '',
    'org_slug' => ''
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-Api-Key: {$YOUR_API_KEY}"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

response = requests.get(
    "https://rueckwaertssuche.net/number/4917345937329",
    headers={"X-Api-Key":"{$YOUR_API_KEY}","Accept":"*/*"},
)

data = response.json()

Query-Parameter

scope

Mit Komma getrennte Aufzählung der Methoden die ausgeführt und ausgegeben werden sollen.

Mögliche Werte: validate, verify, caller-id, meta, hlr-lookup, inverse-lookup

{
  "success": true,
  "version": "1.0.0",
  "phoneNumber": "+4917345937329",
  "formats": {
    "e164": "+4917345937329",
    "international": "+49 173 45937329",
    "national": "0173 45937329",
    "rfc3966": "tel:+49-173-45937329"
  },
  "location": {
    "countryCode": "DE",
    "countryName": "Deutschland",
    "dialingCode": 49,
    "timezones": [
      "Europe/Berlin"
    ]
  },
  "carrier": {
    "type": "MOBILE",
    "name": "Vodafone",
    "brand": "Vodafone",
    "operator": "Vodafone D2 GmbH",
    "mcc": "262",
    "mnc": "02",
    "bands": [
      "GSM 900",
      "LTE 700",
      "LTE 800",
      "LTE 900",
      "LTE 1800",
      "LTE 2100",
      "LTE 2600",
      "5G 700",
      "5G 1800",
      "5G 3500"
    ]
  },
  "isInternational": true,
  "shortNumber": {
    "isPossible": false,
    "isValid": false
  },
  "expectedCost": {
    "amount": "0.10",
    "currency": "EUR"
  }
}

<?xml version="1.0" encoding="UTF-8"?>
<root>
    <success>1</success>
    <version>1.0.0</version>
    <phoneNumber>+4917345937329</phoneNumber>
    <formats>
        <e164>+4917345937329</e164>
        <international>+49 173 45937329</international>
        <national>0173 45937329</national>
        <rfc3966>tel:+49-173-45937329</rfc3966>
    </formats>
    <location>
        <countryCode>DE</countryCode>
        <countryName>Deutschland</countryName>
        <dialingCode>49</dialingCode>
        <timezones>
            <e>Europe/Berlin</e>
        </timezones>
    </location>
    <carrier>
        <type>MOBILE</type>
        <name>Vodafone</name>
        <brand>Vodafone</brand>
        <operator>Vodafone D2 GmbH</operator>
        <mcc>262</mcc>
        <mnc>02</mnc>
        <bands>
            <e>GSM 900</e>
            <e>LTE 700</e>
            <e>LTE 800</e>
            <e>LTE 900</e>
            <e>LTE 1800</e>
            <e>LTE 2100</e>
            <e>LTE 2600</e>
            <e>5G 700</e>
            <e>5G 1800</e>
            <e>5G 3500</e>
        </bands>
    </carrier>
    <isInternational>1</isInternational>
    <shortNumber>
        <isPossible/>
        <isValid/>
    </shortNumber>
    <expectedCost>
        <amount>0.10</amount>
        <currency>EUR</currency>
    </expectedCost>
</root>

Validierung

/number/{number}/validate

Liefert die Validität einer Rufnummer. Überprüft nur das Format, also die Schreibweise einer Rufnummer.

Pfad-Variablen

number

GET /number/4917345937329 HTTP/1.1
Host: rueckwaertssuche.net
Authorization: $YOUR_API_KEY
Accept: */*

curl -L \
  --url 'https://rueckwaertssuche.net/number/4917345937329' \
  --header 'Authorization: $YOUR_API_KEY' \
  --header 'Accept: */*'

const response = await fetch('https://rueckwaertssuche.net/number/4917345937329', {
    method: "POST",
    headers: {
        "Authorization": "$YOUR_API_KEY",
        "Accept": "*/*"
    },
});

const data = await response.json();

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://rueckwaertssuche.net/number/4917345937329",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'app_name' => '',
    'enable_subdomains' => null,
    'network' => '',
    'org_slug' => ''
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "Authorization: Bearer $YOUR_API_KEY"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

response = requests.get(
    "https://rueckwaertssuche.net/number/4917345937329",
    headers={"Authorization":"$YOUR_API_KEY","Accept":"*/*"},
)

data = response.json()

Verifikation

/number/{number}/verify

Liefert die Validität einer Rufnummer. Überprüft nur das Format, also die Schreibweise einer Rufnummer.

Pfad-Variablen

number

Anrufer ID

/number/{number}/caller-id

HLR Abfrage

/number/{number}/hlr-lookup

Rückwärtssuche

/number/{number}/inverse-lookup