Timeline
Returns firearms ordered by year of introduction, optionally bounded to a period. Firearms without a recorded introduction year are excluded.
- stringheaderrequired
Your API key.
Authorization: Bearer <key>is accepted in its place.
- integer
Earliest year of introduction
- Example
- integer
Latest year of introduction
- Example
- string
Restrict to a category slug
- Example
- integerdefault
1Page number
- Range
- 1 – 10000
- Example
- integerdefault
50Items per page (max 100)
- Range
- 1 – 100
- Example
- stringdefault
ascSort order
- Accepts
- Example
- TimelineEntry[]
One page of results
- string
URL-safe slug identifying the firearm, e.g.
glock-17-gen5. - string
Display name, as the maker writes it.
- string | null
Slug of the manufacturer that makes it. Resolve against
/v1/manufacturers/{id}. - string | null
Slug of the category it belongs to. Resolve against
/v1/categories. - integer | null
Year it entered production or service. Null where the date is disputed or unknown.
- integer | null
Year production ended, or null while it is still made.
- string | null
Production status, one of
in_production,discontinued,out_of_production,in_service,limited_production,prototype. Discontinued records are kept deliberately: a rifle built in 2004 wears parts nobody sells today. - string | null
ISO 3166-1 alpha-2 code of where it was designed, e.g.
AT. - 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
Requires Builder tier or higher.
Results are sorted by year_introduced ascending.
Firearms without a known year_introduced are excluded.
Use from and to to narrow the time window.
- Minimum tier
- Builder+
- Monthly quota
- 25,000/mo
- Rate limit
- 60/min
- Daily cap
- 2,000
Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.
This read answers conditional requests. Keep the ETag from a response and send it back as If-None-Match: an unchanged record returns 304 Not Modified with no body, which counts toward your per-minute rate limit but not your daily allowance.