Ammunition

Compute a ballistic table

Computes velocity, energy, drop from the bore and the path from the line of sight at the requested distances for one load, optionally adjusted for a specific barrel length and sighting. Flown through the ICAO standard atmosphere at sea level with the G1 or G7 drag table its ballistic coefficient is stated against.

Requires Builder tier or higher.

get/v1/ammunition/{id}/ballistics

Request

  • Base URL: https://api.gunspec.io
  • URL: https://api.gunspec.io/v1/ammunition/{id}/ballistics
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

Ammunition load slug

Query parameters

barrel_length_mmnumber

Barrel length to adjust muzzle velocity for

distancesstring

Comma-separated distances in metres

zero_minteger

Zero distance in metres, where the bullet crosses the line of sight. Defaults to 25 for a handgun and 100 for a long gun.

sight_height_mmnumber

Line of sight above the bore, in mm. Defaults to 20 for a handgun and 38 for a long gun.

Response

Compute a ballistic table

successboolean required

Always true on a successful response. Every error carries false and an error object instead.

Example response

{
  "success": true,
  "data": {
    "ammunition": {
      "id": "m882",
      "name": "9mm 124gr FMJ",
      "caliberId": "9x19mm-parabellum"
    },
    "barrelLengthMm": 114,
    "muzzleVelocityMps": 360,
    "muzzleEnergyJ": 510,
    "effectiveRangeM": 50,
    "terminalBallistics": {
      "tkoFactor": 12.9,
      "momentumKgMs": 5.7,
      "sectionalDensity": 0.181,
      "hatcherRSP": 103,
      "energyDensityJCm2": 4135.2
    },
    "zeroing": {
      "zeroM": 25,
      "sightHeightMm": 20
    },
    "trajectory": [
      {
        "distanceM": 100,
        "velocityMps": 686,
        "energyJ": 1873,
        "dropCm": 10,
        "pathCm": -3.2,
        "timeOfFlightS": 0.143,
        "machNumber": 2,
        "momentumKgMs": 5.46,
        "tkoFactor": 12.3,
        "energyDensityJCm2": 3801.5
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.