GunSpec

Ammunition

Query individual ammunition loads, retrieve ballistic trajectory tables, calculate firearm-specific performance, and load firearms with full ballistic profiles. Essential for ballistic simulation, ammunition databases, and game development.

Optional AuthExplorer+

Bullet SVG Image

Returns a scale SVG cross-section of the bullet, generated from its recorded dimensions.

GET/v1/ammunition/{id}/bullet.svg

Explorer+

  • stringheader

    Optional. Without a key this endpoint answers under the public policy; a key raises your limits and unlocks plan-gated fields. Authorization: Bearer <key> is accepted in its place.

  • stringrequired

    Ammunition load slug

    Accepts
    a lowercase slug: letters, digits and hyphens
    Example

image/svg+xml

  • header

    image/svg+xml

  • header

    public, max-age=86400, s-maxage=604800 (cached for 24h client / 7 days CDN)

  • 400VALIDATION_ERRORValidation error
  • 404NOT_FOUNDResource not found
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

No authentication required. This is a public image endpoint.

Aggressively cached: 24-hour client cache, 7-day CDN cache.

Every ammunition list/detail response includes a bulletSvgUrl field with the full URL to this endpoint.

Bullet profiles: FMJ (rounded ogive), JHP (hollow cavity), AP (steel penetrator tip), SP (exposed lead tip), OTM (match-grade open tip).

SVG proportions are derived from the caliber's bullet_diameter_mm for realistic scaling.

Ideal for ammunition catalogs, e-commerce product pages, game UIs, and educational material.

Full rate limits

Minimum tier
Explorer+
Monthly quota
200/mo
Rate limit
10/min
Daily cap
50

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.