ForHosting KIT · Developer Utilities

Split a gift budget among recipients by priority

Planning gifts for several people becomes difficult when every recipient does not have the same priority.

● BetaFree · in your browser
Use it from WebAPIEmailTelegramApp soon

This calculator turns one total gift budget and a set of relative weights into a practical amount for each person. It preserves the complete budget down to the cent, makes the reasoning visible, and removes repeated spreadsheet adjustments. Use simple weights such as 3, 2, and 1; only their proportions matter, so there is no need to invent percentages first.

Choose weights that express relative priority

Start with the amount you can spend across all gifts, then list every recipient and give each person a positive priority weight. A weight is not a currency amount and does not need to add up to any particular total. It simply describes relative emphasis. If Alex has weight 4 and Blair has weight 2, Alex receives twice Blair's allocation. The same result comes from weights 2 and 1, or 40 and 20. This flexibility makes weights easier to discuss than fixed amounts when plans are still changing. You might use a higher value for close family, a middle value for good friends, and a lower value for wider social obligations. Avoid using zero to exclude somebody; instead, remove that recipient from the list so the plan states its scope honestly. The calculator validates every weight, adds them together, and uses each person's fraction of that total to determine the person's share of the budget. Names remain in the order submitted, making the result easy to compare with your original list.

Understand cent-accurate proportional allocation

Proportional arithmetic often produces fractions of a cent. A simple rounding step applied separately to every person can leave the final plan a cent or two above or below the available budget. This calculator prevents that mismatch. It first rounds the total budget to cents, calculates each recipient's exact fractional entitlement, and assigns the whole-cent portion. Any cents still unallocated then go to the recipients with the largest fractional remainders. This method is commonly called largest-remainder allocation. It keeps every individual amount to two decimal places while guaranteeing that all returned amounts add up to the returned total budget. When two recipients have the same remainder, the earlier recipient in the submitted list receives the extra cent, providing a stable and deterministic tie-break. The output also includes each normalized share, such as 0.5 for half of the budget, and the total of all priority weights. Those details make it possible to audit the result, explain it to another planner, or reproduce it in a purchasing worksheet without guessing how rounding was handled.

Turn allocations into a realistic gift plan

Treat each allocation as a spending ceiling or planning target rather than a command to find an item at exactly that price. After receiving the split, search for suitable gifts within each amount and keep taxes, delivery charges, wrapping, and shared purchases in mind. If those costs belong inside the total, reserve them before entering the gift budget or include them in the price you compare with each allocation. You can rerun the calculation whenever the recipient list changes, a group gift is added, or your available total rises or falls. Because the same weights preserve the same relationships, adjusting the total does not require rebuilding the plan. For households, committees, or workplace collections, save the input weights beside the output so everyone can see the agreed priorities. The tool does not judge relationships or recommend products; it performs the arithmetic consistently. Via the API, each request costs $0.002, while the browser experience is useful for one-off planning. In either channel, no network lookup, randomness, or current date affects the result.

Plan a family holiday budget

Give closer relatives higher weights while keeping every purchase inside one fixed seasonal spending limit.

Divide a group collection

Allocate pooled money across several thank-you gifts according to priorities agreed by the group.

Rebalance after a budget change

Keep the recipient priorities unchanged and instantly recalculate all targets when the available total changes.

What does a priority weight mean?

It is a relative value. A recipient with weight 6 receives twice the allocation of one with weight 3.

Do the weights need to add up to 100?

No. Any positive weights work because the calculator divides each weight by their combined total.

Will the allocations add up exactly to my budget?

Yes. The budget is rounded to cents, and leftover cents are assigned by largest fractional remainder so the amounts match the returned total.

What happens when two recipients tie for an extra cent?

The recipient appearing earlier in the submitted list receives it, which makes repeated calculations deterministic.

Can I use a zero or negative budget?

No. The total budget must be a positive finite number and must round to at least one cent.

How much does the API request cost?

Each API request costs $0.002. You can also run the calculator in the browser for free.

Everything on this page is available programmatically. This section is for teams who want to wire it into their own systems; everyone else can just use the tool above.

POSThttps://api.kit.forhosting.com/life/gift-budget-split

Prefer to automate it? One authenticated POST creates the task; the result comes back by webhook or a signed link. The same capability also runs here on the web, by email and from Telegram — and soon from our app too.

curl -X POST https://api.kit.forhosting.com/life/gift-budget-split \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_budget":240,"recipients":[{"name":"Alex","priority_weight":3},{"name":"Blair","priority_weight":2},{"name":"Casey","priority_weight":1}]}'
{
  "total_budget": 240,
  "recipients": [
    {
      "name": "Alex",
      "priority_weight": 3
    },
    {
      "name": "Blair",
      "priority_weight": 2
    },
    {
      "name": "Casey",
      "priority_weight": 1
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "life.gift_budget_split",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

The API is asynchronous: the call returns a task_id immediately and the result arrives by webhook. Polling is capped at 1 req/s per task.

Per request$0.002

Published price — no tokens, no invented credits. A failed task is never charged.

max_items1000
HTTPCodeMeaning
401unauthorizedMissing or invalid API key.
402insufficient_balanceYour balance doesn't cover the task price.
404unknown_typeThat task type doesn't exist.
429rate_limitedToo many requests. Use the webhook instead of polling.

Read the full KIT documentation →