Firearm Discovery

List feature icons

Every drawn feature icon, for building a legend or an icon set. A firearm's own come as feature_icon items in /v1/firearms/{id}/media. Each is a WebP on the assets CDN that loads without a key. Needs an API key on every plan, the free one included, and shows the total on every plan.

Available on every plan. Requires an API key; Explorer keys receive a reduced field set.

get/v1/features/icons

Request

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

Query parameters

qstring

Part of an icon's name; spaces and hyphens read as underscores, so picatinny rail finds picatinny_rail

pageinteger

Page number, from 1 to 10,000

per_pageinteger

Items per page (max 100)

Response

List feature icons

successboolean required

Always true on a successful response. Every error carries false and an error object instead.

Example response

{
  "success": true,
  "data": [
    {
      "name": "5r_rifling",
      "label": "5R Rifling",
      "iconUrl": "https://assets.gunspec.io/content/features/simple/5r_rifling.webp"
    }
  ],
  "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.