GunSpec

My Favorites

Save and manage your personal list of favorite firearms. Favorites are scoped to your API key and persist across sessions.

Auth RequiredExplorer+

List Favorite IDs

Returns just the firearm ids you have favorited. Cheaper than the full list when you only need to render a filled/unfilled state.

GET/v1/me/favorites/ids

Explorer+

  • stringheaderrequired

    Your API key. Authorization: Bearer <key> is accepted in its place.

application/json

  • object

    The response payload.

  • string[]

    Slugs of every firearm you have favorited, newest first.

  • 400VALIDATION_ERRORValidation error
  • 401UNAUTHORIZEDAPI key required
  • 403FORBIDDENValid key, not permitted
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Returns only slugs, not full firearm records. Pair it with GET /v1/firearms/{id} when you need details.

Handy for rendering favorite toggles in a list without fetching every record.

Full rate limits

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.