Head to Head
Returns a per-stat verdict between exactly two firearms, plus the win/loss/draw tally across all compared stats.
- stringHeadererforderlich
Ihr API-Schlüssel.
Authorization: Bearer <key>wird ebenfalls akzeptiert.
- stringerforderlich
First firearm slug
- Max. Länge
- 255
- Beispiel
- stringerforderlich
Second firearm slug
- Max. Länge
- 255
- Beispiel
- object
The response payload.
- HeadToHeadFirearm
One of the two compared firearms, as selected: the sixteen columns the verdicts are computed from, snake_case, under their database names.
- string
URL-safe slug identifying the firearm. Stable: it is what a mirror keys on.
- string
Display name, as the maker writes it.
- string | null
Slug of the manufacturer.
manufacturerIdon the camelCase endpoints. - string | null
Slug of the category.
categoryIdon the camelCase endpoints. - number | null
Unloaded weight in grams, without magazine.
- number | null
Overall length in millimetres.
- number | null
Barrel length in millimetres, measured from the breech face.
- integer | null
Standard magazine capacity, in rounds.
- number | null
Muzzle velocity in metres per second, with the reference load.
- number | null
Muzzle energy in joules, with the reference load.
- number | null
Effective range in metres.
- number | null
Cyclic rate of fire in rounds per minute; null for a semi-automatic or manual action.
- HeadToHeadFirearm
One of the two compared firearms, as selected: the sixteen columns the verdicts are computed from, snake_case, under their database names.
- string
URL-safe slug identifying the firearm. Stable: it is what a mirror keys on.
- string
Display name, as the maker writes it.
- string | null
Slug of the manufacturer.
manufacturerIdon the camelCase endpoints. - string | null
Slug of the category.
categoryIdon the camelCase endpoints. - number | null
Unloaded weight in grams, without magazine.
- number | null
Overall length in millimetres.
- number | null
Barrel length in millimetres, measured from the breech face.
- integer | null
Standard magazine capacity, in rounds.
- number | null
Muzzle velocity in metres per second, with the reference load.
- number | null
Muzzle energy in joules, with the reference load.
- number | null
Effective range in metres.
- number | null
Cyclic rate of fire in rounds per minute; null for a semi-automatic or manual action.
- object
One verdict per compared stat, keyed by the stat's camelCase name (
weightEmptyG,overallLengthMm,barrelLengthMm,magazineCapacity,muzzleVelocityMps,muzzleEnergyJ,effectiveRangeM,rateOfFireRpm). A stat neither firearm carries is omitted, so the key set is the stats that could be compared.
- 400
VALIDATION_ERRORValidation error - 401
UNAUTHORIZEDAPI key required - 403
FORBIDDENValid key, not permitted - 404
NOT_FOUNDResource not found - 429
RATE_LIMITEDRate limit exceeded - 500
INTERNAL_ERRORUnexpected server error
Requires Builder tier or higher.
verdicts is an object keyed by the camelCase stat name (weightEmptyG, magazineCapacity ...), not an array. Each entry carries winner (a, b or draw), both values, and better, which says what winning means for that stat (lighter, longer, higher ...).
A stat neither firearm carries is omitted; a firearm that carries a value beats one that does not.
a and b are the sixteen columns the verdicts are computed from, under their snake_case database names, the same rule as /v1/firearms/search.
- Mindeststufe
- Builder+
- Monatskontingent
- 25,000/mo
- Anfragerate
- 60/min
- Tageslimit
- 2,000
Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.
Dieser Aufruf beantwortet bedingte Anfragen. Speichern Sie das ETag einer Antwort und senden Sie es als If-None-Match zurueck: ein unveraenderter Datensatz liefert 304 Not Modified ohne Body. Das zaehlt auf Ihr Minutenlimit, aber nicht auf Ihr Tageskontingent.