List Favorites
Returns the firearms the calling account has favorited, newest first.
- stringHeadererforderlich
Ihr API-Schlüssel.
Authorization: Bearer <key>wird ebenfalls akzeptiert.
- integerstandard
1Page number
- Bereich
- 1 – 10000
- Beispiel
- integerstandard
20Items per page (max 100). Preferred over
limit.- Bereich
- 1 – 100
- Beispiel
- integerstandard
20Legacy alias for
per_page.per_pagewins if both are sent.- Bereich
- 1 – 100
- Beispiel
- FavoriteFirearm[]
One favorited firearm, enough to render a card without a second call. The field names are snake_case here, like the search results and unlike
/v1/firearms.firearm_idandidcarry the same slug. - string
URL-safe slug identifying the firearm. The same value as
firearm_id. - string
Slug of the firearm, under the favorites table's own column name. The same value as
id. - string
When this account favorited it, as the database stamps it (
YYYY-MM-DD HH:MM:SS, UTC). The list is ordered by this, newest first. - string
Display name, as the maker writes it.
- string | null
Slug of the manufacturer.
manufacturerIdon the camelCase endpoints. - string | null
Display name of the manufacturer, joined in so a card renders without a second call.
- string | null
Slug of the category.
categoryIdon the camelCase endpoints. - string | null
Display name of the category.
- FirearmStatus | 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. - integer | null
Year the model was introduced.
- string | null
Operating action as stored, underscored, e.g.
short_recoil,bolt_action,gas_operated. The full vocabulary is/v1/firearms/action-types; a hyphenated value matches nothing. - string | null
ISO 3166-1 alpha-2 code of the country of origin.
- string | null
Line-art silhouette, or null where none has been drawn.
- string | null
GLB model, or null where none is on file.
- integer
How many accounts have favorited this record.
- InlineMediaItem[]
Every image this firearm has, silhouette first. Empty when none are on file.
- integer
Autoincrementing image id.
- string
Absolute, directly fetchable URL.
- MediaKind
What kind of asset a media row is.
- string | null
Alt text, where one has been written. Null otherwise, so do not render an empty string.
- integer | null
Pixel width, where it is known.
- integer | null
Pixel height, where it is known.
- 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
Field names are snake_case here (firearm_id, favorited_at, manufacturer_name), like /v1/firearms/search and unlike /v1/firearms. id and firearm_id carry the same slug.
Favorites are sorted by favorited_at descending (most recently added first).
Each API key maintains its own independent favorites list.
- Mindeststufe
- Explorer+
- Monatskontingent
- 200/mo
- Anfragerate
- 10/min
- Tageslimit
- 50
Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.