Work to raise a mass calculator
Lifting 2 kg through 5 m with g at 9.8 m/s² takes 98 J of work against gravity. Enter mass, local g and the lift height and get the energy a slow, steady lift needs, equal to the potential energy gained. Free in your browser.
- Free
- Runs in your browser
- No sign-up
- Your data stays on your device
Run — free
Worked example
- Mass
- 2
- Height
- 5
- G
- 9.8
- Work
- 98 J
- Precision
- 10
This work to raise a mass calculator finds how much mechanical work you must supply to lift an object vertically against a near-constant gravitational field. You supply the mass, the local gravitational acceleration, and the non-negative lift height; the engine evaluates the closed form W equals m times g times h and reports the result in joules when you use SI units. Physically, a slow lift at constant speed applies an upward force equal to weight through the path length h, so the work done against gravity matches the gravitational potential energy gained. Zero mass or zero height is valid and yields zero work; negative mass or negative height is rejected because this tool models raising, not lowering. Unlike a general W equals F d cos θ calculator that needs force and angle, this page answers the textbook lift problem with only mass, g, and height. The engine is fully deterministic arithmetic: no network calls, no sampling, and no date-dependent shortcuts.
What lifting work means and what you get
In Newtonian mechanics near a planet or moon, when gravitational acceleration is treated as constant over the region of interest, the weight of a point mass is m times g. Raising that mass quasi-statically through a vertical height h means applying an upward force equal to weight through a path of length h, so the work done against gravity is W equals m times g times h.
That same product is the increase in gravitational potential energy PE equals m g h, which is why energy and work chapters often treat the lift problem as interchangeable once kinetic energy is held constant. Mass is the intrinsic property of the object, g is the local gravitational acceleration, and h is the non-negative vertical lift—not a signed elevation change that could describe a drop.
Along a chosen upward axis, positive mass, positive g, and non-negative h produce a non-negative work value in the usual SI convention (energy you must supply to raise the load). Zero mass or zero height is valid and yields zero work when the other factors are finite.
Where work to raise a mass fits in study, design, and software
Students meet W equals m g h when a textbook introduces mechanical work against gravity, when a problem asks how much energy a crane must supply to lift a load a stated height, or when a contest item gives mass, a planetary g, and a lift height and asks for joules. Teachers can pre-generate answer keys for modest mass, g, and height values without trusting opaque calculator apps that silently switch units or confuse general force-times-distance work with the pure vertical lift case.
Developers call the same contract from scripts to seed deterministic test vectors for game physics demos, to normalize user-entered lift problems before an energy diagram, or to satisfy programming-challenge statements that demand joules rather than a hand-waved sketch. Structural and product first-order checks use W equals m g h when only mass, local g, and a required lift are known before safety factors, cable stretch, or multi-axis dynamics are modeled.
What you can do with it
Homework and lift-energy checks
Compute W = m·g·h from mass, g, and lift height before grading worksheets or comparing crane and hoist energy estimates.
Tutoring and teaching software
Normalize user-entered mass, gravity, and height into work for interactive lessons and step helpers.
FAQ
What does the work to raise a mass calculator cost?
It is free in your browser on this page.
What formula is used for work against gravity?
The work is W = m · g · h, where m is mass, g is gravitational acceleration, and h is the non-negative vertical lift height. With SI inputs (kg, m/s², m) the unit is joules (J).
What happens if mass is negative?
Negative mass is not accepted because W = m·g·h has no standard meaning for negative mass in this calculator.
What happens if height is negative?
For signed height change and energy loss on the way down, use a change-in-potential-energy tool.
How is this different from a gravitational PE = m·g·h calculator?
The arithmetic product is the same under constant g, but this page frames the answer as work to raise a mass, requires a non-negative lift height, and targets the search intent for lift and hoist work problems rather than absolute potential energy at a reference level.
Related tools
For developers — API access
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.
API endpoint
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.
Call it from your stack
curl -X POST https://api.kit.forhosting.com/mech/work-against-gravity \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"mass":2,"height":5,"g":9.8}'const res = await fetch("https://api.kit.forhosting.com/mech/work-against-gravity", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"mass": 2,
"height": 5,
"g": 9.8
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/mech/work-against-gravity",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"mass": 2,
"height": 5,
"g": 9.8
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/mech/work-against-gravity", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"mass":2,"height":5,"g":9.8}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"mass":2,"height":5,"g":9.8}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/mech/work-against-gravity", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Example request
{
"mass": 2,
"height": 5,
"g": 9.8
}Example response
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "mech.work_against_gravity",
"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.
Pricing
Published price — no tokens, no invented credits. A failed task is never charged.
Errors
| HTTP | Code | Meaning |
|---|---|---|
401 | unauthorized | Missing or invalid API key. |
402 | insufficient_balance | Your balance doesn't cover the task price. |
404 | unknown_type | That task type doesn't exist. |
429 | rate_limited | Too many requests. Use the webhook instead of polling. |
Technical notes
What work against gravity means and what the response contains
This calculator returns the normalized inputs mass, height, and g, the computed work in joules, the precision used, a method tag work_against_gravity, a short formula reminder, and a unit hint J for SI inputs. There is no numerical integration of a gravity field, no friction or pulley efficiency, and no Monte Carlo sampling: the engine either evaluates the product inside the supported numeric range or rejects the input with invalid_input. Rejected cases include a missing mass, height, or g, non-finite values, magnitudes above the documented ceilings, and any mass or height that is negative, because negative mass has no meaning here and negative height is not a raise.
How mass, height, and g are read and how work stays reproducible
Zero mass is allowed and returns zero work. Height must be finite and non-negative; a negative value is rejected because this capability models raising a mass, not a descent or a signed PE change. Zero height yields zero work for any finite mass and g. Use approximately 9.80665 for standard Earth gravity, about 1.62 for the Moon, or a measured local value from a lab; the tool does not hard-code a planet and does not convert unit systems for you. Optional leading plus signs and scientific notation on numeric strings are allowed when they parse as finite decimals; embedded spaces and non-numeric tokens are rejected. The preferred field for mass is mass, but aliases m and M are accepted so spreadsheets, query strings, and typed forms can reuse the same contract. Mass must be finite and non-negative: a negative value fails with invalid_input and a message that names the field and explains that W equals m times g times h is undefined for negative mass in this calculator, so a bad cell does not become a silent nonsense result. The preferred field for lift height is height, with aliases h, H, lift, and elevation. The preferred field for gravitational acceleration is g, with aliases gravity, gravity_accel, gravitational_acceleration, and accel_g. An optional precision field, with aliases decimals and dp, chooses how many decimal places to expose for the numeric outputs, defaulting to ten and capped at fifteen so JSON goldens stay stable. Pair the free browser run on this page with the priced API when you need the identical mathematical result inside an automated pipeline without re-implementing the work-against-gravity formula yourself.
Where work to raise a mass fits in study, design, and software
Product and education tools use the endpoint when a learner types mass, gravity, and height and the UI must show the work required to raise the object. On this page the work runs entirely in your browser; through the API each successful lookup costs $0.002, failed validation is not charged, and nothing is stored after the response returns. That split — free interactive exploration and a priced, identical API — matches the rest of the KIT tier-A catalog and lets you move from a classroom demo to an automated pipeline without changing the mathematical result. Pair it with potential-energy, work-done, or free-fall helpers when you need related mechanics, and with other math endpoints when you are building a small lab of free, deterministic physics calculators.
Integration use cases
Deterministic test fixtures
Generate reproducible work values for unit tests, game-physics demos, and CI assertions on work against gravity.