My Favorites

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

Page number

Range

1 – 10000

Example

1

Items per page (max 100). Preferred over limit.

Range

1 – 100

Example

20

Legacy alias for per_page. per_page wins if both are sent.

Range

1 – 100

Example

20

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_id and id carry the same slug.

URL-safe slug identifying the firearm. The same value as firearm_id.

Slug of the firearm, under the favorites table's own column name. The same value as id.

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.

Display name, as the maker writes it.

Slug of the manufacturer. manufacturerId on the camelCase endpoints.

Display name of the manufacturer, joined in so a card renders without a second call.

Slug of the category. categoryId on the camelCase endpoints.

Display name of the category.

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.

Year the model was introduced.

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.

ISO 3166-1 alpha-2 code of the country of origin.

Line-art silhouette, or null where none has been drawn.

GLB model, or null where none is on file.

How many accounts have favorited this record.

Every image this firearm has, silhouette first. Empty when none are on file.

Autoincrementing image id.

Absolute, directly fetchable URL.

What kind of asset a media row is.

Alt text, where one has been written. Null otherwise, so do not render an empty string.

Pixel width, where it is known.

Pixel height, where it is known.

Current page number

Items per page

Total matching records (Builder and above)