GunSpec

Conflicts

Resource class for interacting with the GunSpec Conflicts API. Wraps the /v1/conflicts endpoint. Instantiated internally by the GunSpec client and exposed as client.conflicts.

Auth RequiredBuilder+

client.conflicts.list()

List all military conflicts in the database. Returns conflicts with metadata including name, date range, and participating nations. Use the conflict identifiers with client.firearms.byConflict() to find firearms used in a specific conflict.

list(): Promise<APIResponse<Conflict[]>>
GET/v1/conflicts

Builder+

  • stringheaderrequired

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

application/json

  • object[]

    The response payload.

  • string

    Display name, as the maker writes it.

  • integer

    How many firearms this row covers.

  • object[]

    The firearms recorded as used in this conflict.

  • string

    Slug of the firearm.

  • string

    Display name, as the maker writes it.

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

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.