Ballistics Calculator
Returns the ballistic profile for a cartridge out to a chosen distance, using its typical load.
- stringheaderrequired
Your API key.
Authorization: Bearer <key>is accepted in its place.
- stringrequired
Caliber slug
- Max length
- 255
- Example
- integerdefault
100Maximum distance in metres
- Range
- 1 – 5000
- Example
- object
The response payload.
- object
The cartridge the profile was computed for.
- string
Slug of the cartridge.
- string
Display name, as the maker writes it.
- integer
The distance the figures below are quoted at, echoing the
distanceparameter. - number | null
Muzzle velocity in metres per second, for the default load.
- number | null
Muzzle energy in joules, for the default load.
- number | null
Remaining velocity at
distanceM, in metres per second. - number | null
Remaining energy at
distanceM, in joules. - number | null
Time of flight to
distanceM, in seconds. - number | null
Bullet drop below the line of sight at
distanceM, in centimetres.
- 400
VALIDATION_ERRORValidation error - 401
UNAUTHORIZEDAPI key required - 403
FORBIDDENValid key, not permitted - 404
NOT_FOUNDResource not found - 429
RATE_LIMITEDRate limit exceeded - 500
INTERNAL_ERRORUnexpected server error
Requires Builder tier or higher.
Ballistic calculations use a simplified drag model based on bullet weight, diameter, and ballistic coefficient.
Results are approximations suitable for game development and general reference, not precision long-range shooting.
Maximum distance is 5000 meters.
- Minimum tier
- Builder+
- Monthly quota
- 25,000/mo
- Rate limit
- 60/min
- Daily cap
- 2,000
Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.
This read answers conditional requests. Keep the ETag from a response and send it back as If-None-Match: an unchanged record returns 304 Not Modified with no body, which counts toward your per-minute rate limit but not your daily allowance.