Firearms
Compare firearms
Returns full details for up to 5 firearms side by side.
Requires Builder tier or higher.
get/v1/firearms/compare
Request
- Base URL: https://api.gunspec.io
- URL: https://api.gunspec.io/v1/firearms/compare
- Auth: one of:
- API key in header X-API-Key
- HTTP bearer
Query parameters
idsstring required
Comma-separated firearm slugs, maximum 5
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
Compare firearms
Example response
{
"success": true,
"data": {
"items": [
{
"svgLineArtUrl": "https://api.gunspec.io/v1/firearms/glock-g17-gen5/media/silhouette",
"defaultAmmoId": "m882",
"sourceMuzzleVelocityMps": 375,
"sourceMuzzleEnergyJ": 565,
"sourceEffectiveRangeM": 50,
"sourceMaxRangeM": 1800,
"ballisticsSource": "Manufacturer specification sheet",
"ballisticsSourceUrl": "https://eu.glock.com/en/pistols/g17",
"id": "glock-g17-gen5",
"name": "Glock 17 Gen5",
"manufacturerId": "glock",
"categoryId": "pistol",
"parentFirearmId": "glock-17",
"variantType": "generation",
"yearIntroduced": 2017,
"countryOfOrigin": "AT",
"weightEmptyG": 625,
"weightLoadedG": 905,
"overallLengthMm": 204,
"barrelLengthMm": 114,
"heightMm": 139,
"widthMm": 34,
"sightRadiusMm": 165,
"actionType": "short_recoil",
"firingMechanism": "striker-fired",
"triggerType": "safe-action",
"triggerPullN": 28,
"magazineCapacity": 17,
"magazineType": "detachable-box",
"muzzleVelocityMps": 375,
"muzzleEnergyJ": 570,
"effectiveRangeM": 50,
"barrelRifling": "polygonal",
"riflingTwistMm": 250,
"frameMaterial": "polymer",
"slideMaterial": "steel",
"barrelMaterial": "steel",
"finish": "nDLC",
"safetyMechanisms": [
"manual_safety_selector",
"half_cock_notch"
],
"features": [
"collapsible_stock",
"accessory_rail"
],
"feedSystems": [
"detachable_box_magazine"
],
"designer": "Mikhail Kalashnikov",
"foldedLengthMm": 490,
"alternateNames": [
"Avtomat Kalashnikova",
"Type 56",
"Kalash"
],
"firingModes": [
"semi_automatic",
"full_automatic"
],
"conflicts": [
{
"name": "Vietnam War",
"years": "1955-1975",
"sides": [
"North Vietnam / Viet Cong",
"South Vietnam / United States"
]
}
],
"productionNumbers": {
"estimated_total": 75000000,
"production_years": "1947-1975",
"notes": "Approximately 75 million AK-47 type rifles produced."
},
"lore": "The AK-47 is so iconic it appears on the national flag of Mozambique.",
"verifiedAt": "2026-09-25",
"verifiedFields": [
"barrel_length_mm",
"weight_empty_g"
],
"dataConfidence": 0.95,
"createdAt": "2025-01-15 12:00:00",
"updatedAt": "2026-09-10 06:42:19",
"version": "a3f1c2d4e5b6a7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2",
"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"
},
"manufacturer": {
"id": "glock",
"name": "Glock Ges.m.b.H.",
"countryCode": "AT",
"foundedYear": 1963,
"status": "active",
"makesFirearms": true,
"website": "https://www.glock.com",
"createdAt": "2025-01-15 12:00:00",
"updatedAt": "2026-09-10 06:42:19",
"version": "a3f1c2d4e5b6a7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2"
},
"category": {
"id": "pistol",
"name": "Pistol",
"description": "Handguns designed to be fired with one or two hands"
},
"calibers": [
{
"caliberId": "9x19mm-parabellum",
"isPrimary": 1,
"name": "9x19mm Parabellum",
"natoDesignation": "9mm NATO",
"bulletDiameterMm": 9.01,
"caseLengthMm": 19.15,
"cartridgeType": "rimless",
"neckDiameterMm": 9.65,
"baseDiameterMm": 9.93,
"rimDiameterMm": 9.96,
"rimThicknessMm": 1.27,
"overallLengthMm": 29.69,
"bulletLengthMm": 15.5,
"typicalBulletWeightG": 7.45,
"primerType": "small_pistol",
"caseShape": "tapered",
"caseMaterial": "brass",
"projectileKind": "bullet",
"bulletProfile": "round_nose",
"closure": "bullet"
}
],
"images": [
{
"id": 1,
"firearmId": "glock-g17-gen5",
"url": "https://api.gunspec.io/v1/firearms/glock-g17-gen5/images/3076",
"source": "manufacturer",
"license": "fair-use",
"storage": "cdn",
"width": 1200,
"height": 800
}
],
"users": [
{
"id": 1,
"firearmId": "glock-g17-gen5",
"userName": "Austrian Armed Forces",
"userType": "military",
"countryCode": "AT",
"adoptedYear": 1982,
"designation": "Pistole 80"
}
]
}
],
"deltas": [
{
"field": "weightEmptyG",
"values": [
625
],
"min": 625,
"max": 945,
"percentDiff": 51.2
}
]
}
}Changes
No recorded changes to this operation across all 1 revision of this API.