Ammunition

Get an ammunition load

Returns the full specification for a single ammunition load.

Requires Builder tier or higher.

get/v1/ammunition/{id}

Request

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

Path parameters

idstring required

Ammunition load slug

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 an ammunition load

successboolean required

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

Example response

{
  "success": true,
  "data": {
    "id": "m882",
    "caliberId": "9x19mm-parabellum",
    "name": "9mm 124gr FMJ",
    "designation": "M882",
    "manufacturer": "Federal",
    "countryOfOrigin": "US",
    "bulletWeightG": 8.03,
    "bulletType": "fmj",
    "ballisticCoefficientG1": 0.165,
    "referenceVelocityMps": 360,
    "referenceBarrelLengthMm": 114,
    "sectionalDensity": 0.14,
    "yearIntroduced": 1985,
    "isCommon": 1,
    "velocityRetentionExponent": 0.12,
    "description": "Special purpose subsonic 7.62x39mm ammunition.",
    "isMilitary": 1,
    "createdAt": "2026-05-26 12:30:51",
    "updatedAt": "2026-05-26 12:30:51",
    "provenance": {
      "sources": [
        "https://www.glock.com/en/products/pistols/g17-gen5"
      ],
      "sourceKinds": [
        {
          "url": "https://www.glock.com/en/products/pistols/g17-gen5",
          "kind": "manufacturer",
          "archivedFrom": null,
          "rank": 0,
          "tier": "authority",
          "basis": "declared",
          "evidence": null
        }
      ],
      "makerSource": "https://www.glock.com/en/products/pistols/g17-gen5",
      "evidence": "maker",
      "checks": {
        "raised": 3,
        "history": [
          {
            "task": "verify:firearms:glock-g17-gen5",
            "number": 1204,
            "check": "quality:firearm-weight-fits-its-size",
            "kind": "verify",
            "agent": "redback",
            "worker": "redback-046535",
            "status": "resolved",
            "decidedAt": "2026-09-25 07:42:39",
            "proposed": "Read https://us.glock.com/en/pistols/g17-gen5: agrees on barrel_length, weight.",
            "fields": [
              "barrel_length_mm",
              "weight_empty_g"
            ],
            "sources": [
              "https://us.glock.com/en/pistols/g17-gen5"
            ],
            "finding": {
              "why": "2.22 g/cm3 against a submachine-gun / carbon-steel median of 0.64; check the weight and the dimensions",
              "evidence": {
                "apparentDensity": 2.218,
                "categoryMedian": 0.635
              }
            }
          }
        ]
      },
      "dataConfidence": 0.95,
      "verifiedAt": "2026-09-08",
      "verifiedFields": [
        "barrel_length_mm",
        "weight_empty_g"
      ],
      "updatedAt": "2026-09-08 04:10:22",
      "version": "ba5c1d9e06c279a5"
    },
    "version": "e27e61b4b373f5a621d6ae5c67d521096131f2cf56300a1b2c3d4e5f6a7b8c9d"
  }
}

Changes

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