GunSpec

Firearms

Resource class for interacting with the GunSpec Firearms API. Wraps all /v1/firearms endpoints. Instantiated internally by the GunSpec client and exposed as client.firearms.

Auth RequiredStudio+

client.firearms.getAdoptionMap()

Get the worldwide adoption map for a firearm.

getAdoptionMap(id: string): Promise<APIResponse<AdoptionMap>>
GET/v1/firearms/{id}/adoption-map

Studio+

  • stringheaderrequired

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

  • stringrequired

    Resource slug ID

    Accepts
    a lowercase slug: letters, digits and hyphens
    Example

application/json

  • AdoptionMap

    Military and law-enforcement adoption of a firearm, grouped by country.

  • string

    Slug of the firearm this row belongs to.

  • string

    Display name of the firearm the map is for.

  • object[]

    Every country recorded as having adopted it.

  • string | null

    ISO 3166-1 alpha-2 code of the country. Null where the operator country is unrecorded.

  • object[]

    The organisations in that country recorded as operating the firearm.

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

Full rate limits

Minimum tier
Studio+
Monthly quota
150,000/mo
Rate limit
120/min
Daily cap
10,000

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.