openData Studio中文
hambi (Beeline Uzbekistan) icon

hambi (Beeline Uzbekistan) data API

"UNITEL" LLC · Telecom

Open on Google Play

hambi is the self-care app of Beeline Uzbekistan, published by "UNITEL" LLC — the VEON-group company that operates the Beeline brand in Uzbekistan — for the carrier's prepaid and postpaid subscribers. Its home screen shows the main account balance in som, the remaining internet gigabytes and voice minutes with their expiry dates, and the current tariff with its next renewal date and whether it has lapsed. Android home-screen balance widgets in small, medium and large sizes put the same figures on the phone's launcher, with an account picker that lets the user choose which line each widget tracks. Account holders can link family and household SIMs as sub-accounts, give each line its own nickname and picture, and switch between them to check every line's credit and tariff; the profile area keeps the subscriber's name and number, a display theme, and the interface language, with Uzbek and Russian available. Competing in Uzbekistan's mobile market against operators such as Ucell, Mobiuz and Uzmobile, hambi is Beeline's everyday channel for its Uzbek customers to check balances, track tariff renewals and manage a whole family's lines from one login.

Prepaid credit in som, remaining gigabytes and voice minutes, and the tariff's next charge date are the core of what hambi keeps in sync for each Beeline line. The dashboard record pairs a core_balance with a balances array whose buckets carry name, short_name, value, unit and expiration_date, a has_balance_traffic flag, and the active plan with its soc code, total_charged_amount, next_apply_dt renewal date and is_expired flag, plus a customer_info block with the holder's name and birth_date.

The owner profile adds the signed-in MSISDN as phone_number, first_name, middle_name and last_name, a user_type such as PREPAID and an account status, the chosen language and theme, and a permissions array whose code/state flags (WIDGET_BALANCE among them) drive the widget account picker. Every linked family line comes back as its own row with phone_number, a custom_name nickname, its own core_balance, plan, next_apply_dt and state, so one household's SIMs can be read side by side.

Those fields map straight onto integrations: household dashboards that keep remaining som, GB and minutes visible without opening the app; parent-account views that flag which linked SIM is low on credit before its next_apply_dt charge; billing assistants that build a tariff renewal calendar from the plan name, soc and total_charged_amount while skipping lines whose is_expired is already true; and support tools that verify an account holder by matching a ticket's phone number to the owner's name, user_type, status and optional birth_date. openData Studio turns hambi's subscriber balances, tariffs, profiles and family lines into callable open data for teams building on Beeline Uzbekistan accounts.

Screenshots

  • hambi (Beeline Uzbekistan) screenshot 1
  • hambi (Beeline Uzbekistan) screenshot 2
  • hambi (Beeline Uzbekistan) screenshot 3
  • hambi (Beeline Uzbekistan) screenshot 4
  • hambi (Beeline Uzbekistan) screenshot 5
  • hambi (Beeline Uzbekistan) screenshot 6
  • hambi (Beeline Uzbekistan) screenshot 7

API surface

The endpoints and request/response examples below are reconstructed from the app's interface — illustrative, not a live capture.

  • Refresh subscriber access token

    POST /v1/session/renew openbanking

    Exchanges the stored refresh_token for a new access_token used as Authorization: Bearer on every subsequent subscriber call.

    Auth: Refresh token from the stored subscriber session, sent as a query parameter. On HTTP 401 the widget retries after this call, then attaches the returned Bearer access_token.

    • access_token
    • refresh_token
    POST /v1/session/renew?refresh_token=d8f1c2e4... HTTP/1.1
platform: android
app-version: 7.59.0
app-build-number: 31002765
language: ru
Date: 2026-09-26T09:00:00Z
UUID: 3f2b8c1d-9a1e-4c2b-8f01-55c17a91f0e2
    {
  "access_token": "eyJhbGciOi...",
  "refresh_token": "d8f1c2e4..."
}

  • Fetch subscriber dashboard balances

    GET /v1/account/overview openbanking

    Returns the line currently pinned to the home-screen widget: tariff plan, subscriber name, core prepaid balance, and remaining traffic/voice buckets with expiry.

    Auth: Bearer token from /v1/session/renew (Authorization). Also sends language, Date, UUID, Proxy-Authorization, platform=android, app-version, app-build-number, and an optional Cookie. Optional sub-account-id header selects a linked line.

    • plan
    • id
    • name
    • soc
    • next_apply_dt
    • total_charged_amount
    • is_expired
    • customer_info
    • birth_date
    • first_name
    • last_name
    • middle_name
    • core_balance
    • has_balance_traffic
    • balances
    • short_name
    • value
    • expiration_date
    • icon
    • unit
    GET /v1/account/overview HTTP/1.1
Authorization: Bearer eyJhbGciOi...
sub-account-id: 18482911
language: ru
platform: android
app-version: 7.59.0
    {
  "plan": {
    "id": "SOC_HAMBI24",
    "name": "Hambi 24",
    "soc": "HAMBI24",
    "next_apply_dt": "2026-10-12T00:00:00Z",
    "total_charged_amount": "45000",
    "is_expired": false
  },
  "customer_info": {
    "birth_date": "1994-03-12",
    "first_name": "Aziza",
    "last_name": "Karimova",
    "middle_name": "Olimovna"
  },
  "core_balance": "12500.00",
  "has_balance_traffic": true,
  "balances": [
    {
      "name": "Internet",
      "short_name": "GB",
      "value": "8.4",
      "expiration_date": "2026-10-12T00:00:00Z",
      "icon": "internet",
      "unit": "GB"
    }
  ]
}

  • Read signed-in subscriber profile

    GET /v1/account/owner osint

    Loads the authenticated Beeline MSISDN, legal name, user type/status, UI language/theme, and permission flags used by the widget account picker.

    Auth: Bearer token from /v1/session/renew (Authorization). Also sends language, Date, UUID, Proxy-Authorization, platform=android, app-version, app-build-number, and an optional Cookie.

    • id
    • phone_number
    • first_name
    • middle_name
    • last_name
    • user_type
    • status
    • custom_name
    • custom_image
    • language
    • theme
    • addable_as_sub_account
    • show_customization_page
    • permissions
    • code
    • state
    GET /v1/account/owner HTTP/1.1
Authorization: Bearer eyJhbGciOi...
language: uz
platform: android
    {
  "id": 18482911,
  "phone_number": "998901234567",
  "first_name": "Aziza",
  "middle_name": "Olimovna",
  "last_name": "Karimova",
  "user_type": "PREPAID",
  "status": "ACTIVE",
  "custom_name": "My hambi",
  "custom_image": null,
  "language": "ru",
  "theme": "light",
  "addable_as_sub_account": true,
  "show_customization_page": false,
  "permissions": [
    {"id": 1, "code": "WIDGET_BALANCE", "name": "Balance widget", "state": true}
  ]
}

  • List family sub-accounts

    GET /v1/account/lines openbanking

    Returns linked household/family lines with each MSISDN, nickname, core_balance and plan so the widget can pin a sub-account via the sub-account-id header.

    Auth: Bearer token from /v1/session/renew (Authorization). Also sends language, Date, UUID, Proxy-Authorization, platform=android, app-version, app-build-number, and an optional Cookie.

    • id
    • sort
    • phone_number
    • custom_name
    • first_name
    • middle_name
    • last_name
    • core_balance
    • plan
    • next_apply_dt
    • status
    • state
    • user_type
    • custom_image
    GET /v1/account/lines HTTP/1.1
Authorization: Bearer eyJhbGciOi...
language: ru
platform: android
    [
  {
    "id": 18483002,
    "sort": 1,
    "phone_number": "998907654321",
    "custom_name": "Kids SIM",
    "first_name": "Timur",
    "middle_name": null,
    "last_name": "Karimov",
    "core_balance": 3200.5,
    "plan": "Hambi Kids",
    "next_apply_dt": "2026-10-05T00:00:00Z",
    "status": 1,
    "state": "ACTIVE",
    "user_type": "PREPAID",
    "custom_image": null
  }
]

Data categories

  • balances
  • plans
  • subscriber-profile
  • sub-accounts

Where teams use this data

  • Home-screen prepaid balance sync

    Ops dashboards poll /v1/account/overview for core_balance, balances[].value/unit/expiration_date and plan.is_expired so a household always sees remaining som, GB and minutes without opening the app.

  • Family-line spend overview

    A parent-account view joins /v1/account/lines (phone_number, custom_name, core_balance, plan, next_apply_dt) with dashboard buckets to flag which linked SIM is low on credit before the next_apply_dt charge.

  • Tariff renewal calendar

    Billing assistants copy plan.name, soc, total_charged_amount and next_apply_dt from the dashboard payload into a renewal calendar, skipping lines where is_expired is already true.

  • Subscriber identity matching

    Support tools match a ticket MSISDN to /v1/account/owner (phone_number, first_name, last_name, user_type, status) and optional customer_info.birth_date from the dashboard when verifying the account holder.

Frequently asked questions

Which hambi endpoint returns prepaid balance and traffic buckets?

GET /v1/account/overview returns core_balance plus a balances array (name, short_name, value, unit, expiration_date) and the current plan (soc, next_apply_dt, is_expired). Pass the sub-account-id header to read a linked line.

How does the hambi widget stay signed in?

It stores an access_token and refresh_token from the signed-in session. POST /v1/session/renew?refresh_token=… issues a new pair; subsequent calls send Authorization: Bearer plus language, Date, UUID and app-version headers.

Can hambi expose family or extra SIMs, not just the owner line?

Yes. GET /v1/account/lines returns each linked phone_number, custom_name, core_balance, plan and next_apply_dt. The widget then calls the account overview with that row's id as the sub-account-id header.

What does the hambi subscriber profile endpoint return?

GET /v1/account/owner returns the signed-in MSISDN as phone_number along with first_name, last_name, user_type and status, plus UI preferences (language, theme) and a permissions array whose code/state flags, such as WIDGET_BALANCE, drive the widget account picker.

Apps similar to hambi (Beeline Uzbekistan)

  • Ucell — Ucell is COSCOM's official self-care app for Uzbekistan subscribers: check remaining balances, change tariffs, top up from a bank card, and manage several numbers from one login.
  • Mobiuz — Mobiuz is Universal Mobile Systems' account app for Uzbekistan, used to check balance and remaining traffic, top up, connect or disconnect services, and change a tariff plan.
  • My Uztelecom — My Uztelecom is Uzbektelecom's official app for Uzmobile mobile and Uzonline home-internet accounts, covering leftover traffic, extra SMS/internet/voice packages, and tariff changes.
  • HUMANS — HUMANS is a digital mobile operator on Uzbekistan's UzMobile network whose super-app handles mobile tariffs, SIM activation, top-ups and card-to-card transfers in one place.
  • OQ — OQ is UNITEL's digital-first Uzbekistan operator: in the app, subscribers pick a number, build a custom voice/SMS/data plan, verify identity remotely, and activate eSIM or SIM.

More Telecom apps

Topics

  • hambi API
  • Beeline Uzbekistan
  • UNITEL
  • subscriber balance API
  • core_balance
  • sub-accounts
  • tariff next_apply_dt
  • hambi widget
  • Beeline self-care data API

Need this app's data API integrated?

We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.

  • NDA + SOW on every engagement
  • Delivery in 3–7 days
  • Payment only after acceptance
  • Work scoped to authorized use

Get a quote