List sellers stocking a firearm

Who stocks this firearm and where to buy it. The same three guards as an attachment's offers apply: only approved vendors appear, an offer not refreshed within 30 days is hidden, and region hides sellers who do not ship there. Offers link out; GunSpec never takes the order.

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

get/v1/firearms/{id}/offers

Request

Base URL: https://api.gunspec.io
URL: https://api.gunspec.io/v1/firearms/{id}/offers
Auth: one of:
- API key in header X-API-Key
- HTTP bearer

Path parameters

idstring required

Firearm slug

Query parameters

regionstring

ISO 3166-1 alpha-2 code; hides sellers who do not ship there

Response

List sellers stocking a firearm

successboolean required

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

Example response

{
  "success": true,
  "data": [
    {
      "vendor": {
        "id": "example-optics",
        "name": "Example Optics",
        "website": "https://example-optics.com",
        "logoUrl": "https://example-optics.com/logo.svg",
        "verifiedDomain": "example-optics.com"
      },
      "sku": "AIM-ACRO-P2",
      "priceCents": 129900,
      "currency": "AUD",
      "url": "https://example-optics.com/products/aimpoint-acro-p-2",
      "inStock": true,
      "clickId": "a1b2c3d4e5f60718",
      "region": "AU",
      "updatedAt": "2026-09-08 04:11:00"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.