Calibers

Get a caliber ballistic profile

Returns the ballistic profile for a cartridge out to a chosen distance, using its typical load.

Requires Builder tier or higher.

get/v1/calibers/ballistics

Request

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

Query parameters

idstring required

Caliber slug

distanceinteger

Maximum distance in metres

Headers

If-None-Matchstring

The ETag from a previous response. If the body would be byte-identical, the API answers 304 Not Modified with no body. A 304 counts toward the per-minute rate limit but not the daily request allowance.

Response

Get a caliber ballistic profile

successboolean required

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

Example response

{
  "success": true,
  "data": {
    "caliber": {
      "id": "9x19mm-parabellum",
      "name": "9x19mm Parabellum"
    },
    "distanceM": 100,
    "muzzleVelocityMps": 360,
    "muzzleEnergyJ": 510,
    "velocityAtDistanceMps": 340,
    "energyAtDistanceJ": 455,
    "timeOfFlightS": 0.31,
    "bulletDropCm": -3.8
  }
}

Changes

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