Releases

List new firearm models

Returns new firearm models, newest announcement first, each with the date it was announced, the date GunSpec first read it, its alternate names and the pages that name it. A model appears only after research has read a source a reader can cite (the maker, a standards body, a government, a reference work or the press) and quoted the words that name it; a headline alone never makes a row. status says whether the catalog holds a record yet (catalogued, with catalogueId) or not (announced). Filter by day with since and until: they apply to announcedAt, or to the day GunSpec first read the model with order=consumed. A model with no dated source counts from the day it was first read.

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

get/v1/releases

Request

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

Query parameters

pageinteger

Page number, from 1 to 10,000

per_pageinteger

Items per page (max 100)

sincestring

Only models on or after this day (YYYY-MM-DD)

untilstring

Only models on or before this day (YYYY-MM-DD)

makerstring

Filter by catalog manufacturer id

status'announced' | 'catalogued'

Filter by whether the catalog holds a record yet

qstring

Search the model name, its alternate names and the maker

order'announced' | 'consumed'

Sort and date-filter by the announcement date, or by the day GunSpec first read the model

Response

List new firearm models

successboolean required

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

Example response

{
  "success": true,
  "data": [
    {
      "id": "7c3f2a90-5e1b-4d8a-9b6c-2f4e8a1d0c35",
      "slug": "northfield-arms-nf-9-compact",
      "name": "Northfield Arms NF-9 Compact",
      "alternateNames": [
        "NF-9C"
      ],
      "manufacturer": {
        "id": "northfield-arms",
        "name": "Northfield Arms"
      },
      "status": "announced",
      "announcedAt": "2026-09-18",
      "releasedAt": "2026-11",
      "releasedPrecision": "month",
      "firstSeenAt": "2026-09-19T04:15:02Z",
      "updatedAt": "2026-09-21T09:30:11Z",
      "bestSourceKind": "manufacturer",
      "sources": [
        {
          "url": "https://www.example.com/news/northfield-nf-9-compact",
          "kind": "manufacturer",
          "publisher": "Northfield Arms",
          "publishedAt": "2026-09-18"
        }
      ]
    }
  ],
  "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.