Load a firearm with an ammunition type

Returns the full ballistic profile for a firearm chambered with a given load: muzzle velocity and energy, effective range, terminal indices, and the trajectory sampled from the muzzle out to 1000 m.

Each trajectory point carries velocity, energy, drop from the bore, path from the line of sight for the answer's zeroing, time of flight, Mach number, momentum, Taylor Knock-Out factor and energy density, so the whole drop table can be rendered from one call. The trajectory is flown through the ICAO standard atmosphere at sea level.

When the firearm has no recorded barrel length, or no load can be resolved for its primary caliber, the response is still 200 and carries an error string in place of the computed blocks.

Requires Builder tier or higher.

get/v1/firearms/{id}/load

Request

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

Path parameters

idstring required

Resource slug ID

Query parameters

ammo_idstring

Ammunition load to chamber. Defaults to the firearm default load, then the first common load for its primary caliber.

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

Load a firearm with an ammunition type

successboolean required

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

Example response

{
  "success": true,
  "data": {
    "firearm": {
      "id": "ak-47",
      "name": "AK-47",
      "barrelLengthMm": 415
    },
    "ammunition": {
      "id": "m43-ball",
      "name": "M43 Ball",
      "caliberId": "7-62x39mm",
      "bulletWeightG": 7.97,
      "bulletType": "FMJ"
    },
    "calculated": {
      "muzzleVelocityMps": 715,
      "muzzleEnergyJ": 2037,
      "effectiveRangeM": 414,
      "terminalBallistics": {
        "tkoFactor": 12.9,
        "momentumKgMs": 5.7,
        "sectionalDensity": 0.181,
        "hatcherRSP": 103,
        "energyDensityJCm2": 4135.2
      }
    },
    "sourceReported": {
      "muzzleVelocityMps": 710,
      "muzzleEnergyJ": 2010,
      "effectiveRangeM": 300
    },
    "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.