Get a caliber
Returns the full record for one cartridge: SAAMI/CIP dimensions, case shape, projectile, origin, parent cartridge and provenance.
Example usage
- 1
A person asks
- What are the dimensions of the 9x19mm Parabellum cartridge?
- 2
The assistant calls the tool
tools/calljson{ "name": "gunspec_get_caliber", "arguments": { "id": "9x19mm-parabellum" }} - 3
The server answers
Resultjson{ "id": "9x19mm-parabellum", "name": "9x19mm Parabellum", "aliases": [ "7N21", "7N31", "9mm" ], "natoDesignation": "9mm NATO", "bulletDiameterMm": 9.01, "neckDiameterMm": 9.65, "baseDiameterMm": 9.93, "caseLengthMm": 19.15, "overallLengthMm": 29.69, "maxPressureMpa": 235, "maxPressurePsi": 34084, "typicalBulletWeightG": 7.45, "typicalMuzzleVelocityMps": 360, "typicalMuzzleEnergyJ": 481, "primerType": "small_pistol", "cartridgeType": "rimless", "parentCartridgeId": "7-65x21mm-parabellum", "yearIntroduced": 1902, "designer": "Georg Luger", "rimDiameterMm": 9.96, "rimThicknessMm": 1.27, "shoulderDiameterMm": null, "bulletLengthMm": 12.9, "caseShape": "tapered", "caseMaterial": "brass", "projectileKind": "bullet", "bulletProfile": "round_nose", "closure": "bullet", "markingColor": null, "markingMeaning": null, "specSource": "https://bobp.cip-bobp.org/uploads/tdcc/tab-iv/tabivcal-en-page28.pdf", "specStandard": "cip", "dataConfidence": 0.95, "verifiedAt": "2026-10-03", "verifiedFields": [ "base_diameter_mm", "bullet_diameter_mm", "case_length_mm" ], "createdAt": "2026-02-11 23:44:40", "updatedAt": "2026-10-04 11:27:58", "version": "d19f758e24071a6793e3a3509f859f72c856ac63aa8edeb1d909fb8392649840", "provenance": { "sources": [], "sourceKinds": [], "bestSourceKind": null, "makerSource": null, "evidence": "verified", "dataConfidence": 0.95, "verifiedAt": "2026-10-03", "verifiedFields": [ "base_diameter_mm", "bullet_diameter_mm", "case_length_mm" ], "specSource": "https://bobp.cip-bobp.org/uploads/tdcc/tab-iv/tabivcal-en-page28.pdf", "updatedAt": "2026-10-04 11:27:58", "version": "d19f758e24071a6793e3a3509f859f72c856ac63aa8edeb1d909fb8392649840" }}Captured from the live API on Oct 22, 2026. Lists and long text are shortened for display.
Related references
Arguments
- stringrequired
The caliber slug, e.g. as returned by a list or search tool.
- Sent as
- {id}
Each argument is sent to GET /v1/calibers/{id} as the parameter shown, so the same request can be made to the API directly, with your key, if you want to shape what comes back.
json