List ammunition loads

Returns a paginated list of specific ammunition loads across all calibers.

Requires Builder tier or higher.

get/v1/ammunition

Request

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

Query parameters

pageinteger

Page number, from 1 to 10,000

per_pageinteger

Items per page (max 100)

qstring

Substring match on the load name, designation, maker or cartridge name

caliber_idstring

Filter by caliber slug

bullet_typestring

Filter by bullet construction

is_commoninteger

Restrict to commonly stocked loads (1) or uncommon ones (0)

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

List ammunition loads

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"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "limit": 20,
    "total": 42,
    "totalPages": 3
  }
}

Changes

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