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.
- stringheaderrequired
Your API key.
Authorization: Bearer <key>is accepted in its place.
- integerdefault
1Page number, from 1 to 10,000
- Range
- 1 – 10000
- Example
- integerdefault
20Items per page (max 100)
- Range
- 1 – 100
- Example
- string
Only models on or after this day (
YYYY-MM-DD)- Max length
- 10
- Example
- string
Only models on or before this day (
YYYY-MM-DD)- Max length
- 10
- string
Filter by catalog manufacturer id
- Max length
- 100
- Example
- string
Filter by whether the catalog holds a record yet
- Accepts
- string
Search the model name, its alternate names and the maker
- Max length
- 100
- stringdefault
announcedSort and date-filter by the announcement date, or by the day GunSpec first read the model
- Accepts
- Example
- object[]
A new firearm model: its name and alternate names, the dates it was announced and first read, and the sources that name it.
- string
Stable id of the release row.
- string
The id the catalog gives the model once it holds a record. Informational: it can change if research settles a different name, so key on
id. - string
The model's name as the maker writes it, settled by research from a page that states it.
- string[]
Other names the sources give the model. Each appears on a page research read; none is inferred.
- object | null
The maker.
idis the catalog manufacturer id, or null when the catalog holds no record of the maker yet. - string | null
Catalog manufacturer id.
- string
Maker name.
- string
Whether the catalog holds a record for the model yet.
- string | null
The firearm id once
statusiscatalogued, forGET /v1/firearms/{id}. Null before. - string | null
The date (
YYYY-MM-DD) of the earliest source a reader can cite that names the model. Null when no source carried a date. - string | null
When a source says the model ships or goes on sale, at the precision it gave:
YYYY,YYYY-MMorYYYY-MM-DD. Null when no source states a date. "Spring 2027" is not a date and is never turned into one. - string | null
How much of
releasedAtthe source gave. - string
When GunSpec first read the model (UTC): the date we consumed it. Always present.
- string
When the row last changed (UTC).
- string | null
The strongest kind among
sources, strongest first: the maker's own page, a standards body, a government, a reference work, then press. - object[]
The pages that name the model, oldest first. Every release has at least one of a citable kind.
- string
A page that names the model. Open it to check the claim.
- string
What kind of page it is (
SourceKind). - string | null
Who published it, when known.
- string | null
The page's own date (
YYYY-MM-DD), when it carried one. - number
Current page number
- number
Items per page
- number
Total matching records (Builder and above)
- 400
VALIDATION_ERRORValidation error - 401
UNAUTHORIZEDAPI key required - 403
FORBIDDENValid key, not permitted - 429
RATE_LIMITEDRate limit exceeded - 500
INTERNAL_ERRORUnexpected server error
- 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.