GunSpec

Countries

Country-level military and law enforcement adoption data. Discover which countries use which firearms.

Auth RequiredExplorer+

List Countries

Returns every country that has adopted a catalogued firearm, ranked by how many distinct firearms it operates.

GET/v1/countries

Explorer+

  • stringheaderrequired

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

application/json

  • object[]

    The response payload.

  • string

    ISO 3166-1 alpha-2 country code.

  • integer

    Distinct catalogued firearms this country operates.

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

Countries are sorted by firearm_count descending.

Only countries with at least one adoption record are included.

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.

Auth RequiredBuilder+

Country Arsenal

Returns the firearms in service with one country, grouped by operator type (military, law enforcement, and so on).

GET/v1/countries/{code}/arsenal

Builder+

  • stringheaderrequired

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

  • stringrequired

    ISO 3166-1 alpha-2 country code

    Example

application/json

  • object

    The country arsenal, keyed by operator type.

  • string

    ISO 3166-1 alpha-2 code of the country, echoing the path parameter.

  • object

    Operator type -> the firearms that type operates. Keys are dynamic; entries missing a type are grouped under "unknown".

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

Requires Builder tier or higher.

Country code must be a valid ISO 3166-1 alpha-2 code (e.g. US, DE, GB, RU, CN).

Records within each group are sorted by adopted_year descending (most recent first).

Empty arrays indicate no adoption records for that user type.

Full rate limits

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.