PhoneStatus API

REST API: пробив личности по номеру, кредитный скор, проверка почты. Самообслуживание — ключ берёшь в Telegram-боте.

Старт за 30 секунд

1. В боте: 👤 Профиль → 🔑 API — там твой персональный ключ.
2. Шли его в заголовке каждого запроса. 3. Готово.

База: https://api.nimblenest.org/api

Авторизация: Authorization: Bearer <ключ>  или  X-API-Key: <ключ>

Формат: тело и ответ — JSON (Content-Type: application/json).

Методы

POST/api/lookup/phone

Пробив личности по US-номеру: имя, дата рождения, адрес, почты.

Запрос

{ "phone": "2092012780" }

Ответ (200)

{
  "ok": true, "found": true, "phone": "2092012780",
  "name": "Marquez Mcgee",
  "dob": "06/25/1985", "age": 40,
  "address": { "street": "529 W Flora St", "city": "Stockton", "state": "CA", "zip": "95203" },
  "emails": ["mmcgee@yahoo.com"]
}

Если личность не найдена → {"ok":false,"found":false,"outcome":"NOT_FOUND"} (не тарифицируется).

POST/api/lookup/credit-score

Кредитный скор (soft pull). Личность задаётся двумя способами:

А) по номеру — бот сам резолвит данные

{ "phone": "2092012780" }

Б) по готовым данным — точный матч / номера нет в базе

{
  "first": "Marquez", "last": "Mcgee", "dob": "06/25/1985",
  "street": "529 W Flora St", "city": "Stockton", "state": "CA", "zip": "95203",
  "ssn": "123456789"
}

dob: MM/DD/YYYY или YYYY-MM-DD. ssn — опционально (нужен, если бюро требует, см. REQUIRE_SSN).

Ответы (200)

{ "ok": true, "score": 712, "bureau": "TransUnion", "name": "Marquez Mcgee" }
{ "ok": true, "frozen": true, "score": null, "name": "..." }
{ "ok": false, "outcome": "REQUIRE_SSN", "detail": "SSN required for this identity" }
{ "ok": false, "outcome": "NO_SCORE",   "detail": "no credit file for this identity" }
POST/api/lookup/emailтолько Full-подписка

Проверка почты: регистрация (где заведена) + траст (репутация, утечки, одноразовость).

Запрос

{ "email": "john@yahoo.com" }

Ответ (200)

{
  "ok": true, "email": "john@yahoo.com",
  "registration": "TAKEN",
  "trust": {
    "tier": "HIGH_TRUST", "reputation": "high",
    "data_breach": true, "disposable": false, "free_provider": true,
    "profiles": 1, "mx": "..."
  }
}

Поле registration

TAKEN занята (реальный ящик) AVAILABLE свободна / ящика нет DOMAIN_CLOSED домен закрыт для регистрации INVALID невалидный адрес UNSUPPORTED домен не чекаем (gmail и пр. — но траст есть)

Поддержка реги: Microsoft (outlook/hotmail) и Yahoo-семья (yahoo/aol/att/sbcglobal/bellsouth…). Траст — по любой почте. Без Full-подписки → 402.

Коды ответа

HTTPЗначение
200Ок (смотри поле ok в теле: true/false)
401Ключ отсутствует / неверный / отозван
402Недостаточно баланса/подписки (email — нужна Full)
429Превышен лимит (1 запрос / 3 c)
400Неверный запрос (нет номера/данных/почты)

Оплата — как в чате (баланс/подписка). Неуспешный пробив/скор — деньги возвращаются автоматически. Лимит: 1 запрос / 3 с на ключ.

Примеры

curl

curl https://api.nimblenest.org/api/lookup/phone \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"2092012780"}'

python

import requests
KEY = "ваш_ключ"
r = requests.post(
    "https://api.nimblenest.org/api/lookup/email",
    headers={"Authorization": f"Bearer {KEY}"},
    json={"email": "john@yahoo.com"},
    timeout=120)
print(r.json())