README.md

my-kyivstar cli interface

---

NOTE: After Kyivstar changed their authentication logic on web interface - this script doesn't work anymore

For details (or if you willing to fix it) see #2 (comment)

---

Grabs balance and useful statistics from https://account.kyivstar.ua Парсит баланс и полезную статистику из https://account.kyivstar.ua

Login logic completely based on php implementation: https://github.com/dukegh/kyivstar Many thanks to him for this!

Install

Python 3.6+ required.

sudo pip install my-kyivstar

Create config in ~/.my-kyivstar.yaml

phone: +380...
password: your-password

Then run my-kyivstar to get balance.

Response example:

PREPAID 44,22 грн [Следующий платеж (28.11.2018) 95,00]
Минуты на другие мобильные: 01 ч. 15 мин. [28.11.2018]
Интернет: 4 496 МБ [28.11.2018]
SMS по Украине: 0 SMS [28.11.2018]
Остаток бонусных средств  «Экстра Деньги» 0,00 грн [21.02.2026]

Or you can get raw json using my-kyivstar --json:

{
  "accountData": {
    "balance": "30,42",
    "gsmNextPaymentValue": {
      "label": "Следующий платеж (29.07.2018)",
      "value": "95,00"
    }
  },
  "bonusBalance": {
    "availableAmountSum": "0,00",
    "bonusBalances": [
      {
        "balanceAmount": [
          {
            "unit": "SMS",
            "value": "150"
          }
        ],
        "bonusExpirationDate": "29.07.2018",
        "name": "SMS по Украине:"
      },
      {
        "balanceAmount": [
          {
            "unit": "МБ",
            "value": "4 300"
          }
        ],
        "bonusExpirationDate": "29.07.2018",
        "name": "Интернет:"
      },
      {
        "balanceAmount": [
          {
            "unit": "грн",
            "value": "0,00"
          }
        ],
        "bonusExpirationDate": "21.02.2026",
        "name": "Остаток бонусных средств  «Экстра Деньги»"
      },
      {
        "balanceAmount": [
          {
            "unit": "ч.",
            "value": "02"
          },
          {
            "unit": "мин.",
            "value": "22"
          }
        ],
        "bonusExpirationDate": "29.07.2018",
        "name": "Минуты на другие мобильные:"
      }
    ]
  },
  "currencyName": "грн",
  "currentSubscription": {
    "bonusBalance": "0,00"
  },
  "isTransferAvailable": "",
  "isTransferEnabled": "",
  "paymentHistoryPageUrl": "/ecare/usageStatus",
  "rechargePageUrl": "/ecare/recharge",
  "subscriptionType": "PREPAID"
}

Authors

• dukegh - PHP implementation.
• me - Just a handsome guy, you know.

License

This project is licensed under the MIT License.