GunSpec

Countries

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

Authentifizierung erforderlichExplorer+

client.countries.list()

List all countries that have adopted at least one firearm.

list(): Promise<APIResponse<Country[]>>
GET/v1/countries

Explorer+

  • stringHeadererforderlich

    Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

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

Alle Anfragelimits

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.

Authentifizierung erforderlichBuilder+

client.countries.getArsenal()

Get the full firearm arsenal for a specific country. Returns all firearms adopted by the country, grouped by usage type (military, law enforcement, etc.).

getArsenal(code: string): Promise<APIResponse<CountryArsenal>>
GET/v1/countries/{code}/arsenal

Builder+

  • stringHeadererforderlich

    Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

  • stringerforderlich

    ISO 3166-1 alpha-2 country code

    Beispiel

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

Alle Anfragelimits

Mindeststufe
Builder+
Monatskontingent
25,000/mo
Anfragerate
60/min
Tageslimit
2,000

Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.