Numery

Sprawdź numer (HLR)

Pyta operatora, czy numer jest aktywny w sieci i w jakiej - bez wysyłania SMS-a. Przydatne przed kampanią (czyszczenie bazy z martwych numerów) i przy weryfikacji numeru w rejestracji.

Koszt: price_per_hlr_grosze z GET /v1/account (domyślnie 5 gr = 0,05 zł), pobierany z salda jak SMS. Ponowne sprawdzenie tego samego numeru w ciągu 24 h zwraca wynik z pamięci (cached: true, cost_grosze: 0) bez pytania operatora.

Konto testowe: tylko numery zweryfikowane w panelu (inaczej 403), bez opłaty. Przy braku środków 402. Wymaga zakresu send.

get/v1/numbers/{msisdn}/lookup

Request

Base URL: https://api.przypominamy.com
URL: https://api.przypominamy.com/v1/numbers/{msisdn}/lookup
Auth: HTTP bearer

Path parameters

msisdnstring required

Numer w E.164 (plus zakoduj jako %2B albo pomiń); 9 cyfr = numer polski

Response

Wynik sprawdzenia

msisdnstring

status'active' | 'inactive' | 'invalid' | 'unknown'

active - numer w sieci; inactive - nieosiągalny lub nieistniejący; invalid - zły format; unknown - operator nie odpowiedział jednoznacznie

networkstring nullable

Nazwa sieci (Plus, T-Mobile, Orange, Play…)

mccstring nullable

mncstring nullable

portedboolean nullable

Czy numer został przeniesiony do innej sieci

cost_groszeinteger

Pobrana opłata (0 dla wyniku z pamięci i na koncie testowym)

cachedboolean

true - wynik z ostatnich 24 h, bez opłaty i bez pytania operatora

checked_atstring date-time

Kiedy operator sprawdził numer

Example response

{
  "msisdn": "+48600100200",
  "network": "T-Mobile",
  "mcc": "260",
  "mnc": "02",
  "cost_grosze": 5
}

Changes

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