---
title: "Sprawdź numer (HLR)"
method: GET
path: "/v1/numbers/{msisdn}/lookup"
tags: ["Numery"]
---

# Sprawdź numer (HLR)

`GET /v1/numbers/{msisdn}/lookup`

## Request

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

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`.

## Path parameters

- `msisdn` string, required

## Response `200`

Wynik sprawdzenia

- HlrResult
  - `msisdn` string
  - `status` 'active' | 'inactive' | 'invalid' | 'unknown': `active` - numer w sieci; `inactive` - nieosiągalny lub nieistniejący; `invalid` - zły format; `unknown` - operator nie odpowiedział jednoznacznie
  - `network` string, nullable: Nazwa sieci (Plus, T-Mobile, Orange, Play…)
  - `mcc` string, nullable
  - `mnc` string, nullable
  - `ported` boolean, nullable: Czy numer został przeniesiony do innej sieci
  - `cost_grosze` integer: Pobrana opłata (0 dla wyniku z pamięci i na koncie testowym)
  - `cached` boolean: `true` - wynik z ostatnich 24 h, bez opłaty i bez pytania operatora
  - `checked_at` string, date-time: Kiedy operator sprawdził numer

## Other responses

- `400`: Błąd walidacji
- `401`: Brak lub nieprawidłowy klucz API
- `402`: Niewystarczające środki na sprawdzenie
- `403`: Klucz bez zakresu `send` albo konto testowe i niezweryfikowany numer
- `502`: Błąd lub brak odpowiedzi dostawcy SMS (502/504)

---

[API](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api.md) · [All operations](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/przypominamy/apis/przypominamy-com-sms-api/revisions/c20f9cfc2a7d?raw)