Papers

List research papers

Returns the research papers GunSpec has published, newest first: technical reports built on the catalogue and the published methods.

Available on every plan. Requires an API key; Explorer keys receive a reduced field set.

get/v1/papers

Request

  • Base URL: https://api.gunspec.io
  • URL: https://api.gunspec.io/v1/papers
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

pageinteger

Page number, from 1 to 10,000

per_pageinteger

Items per page (max 100)

topicstring

Filter by topic

Response

List research papers

successboolean required

Always true on a successful response. Every error carries false and an error object instead.

Example response

{
  "success": true,
  "data": [
    {
      "id": "5f0c1e8a-2d3b-4c6e-9a1f-7b8c9d0e1f2a",
      "slug": "rifle-mass-and-the-energy-cost-of-a-foot-march",
      "title": "Rifle mass and the energy cost of a foot march",
      "reportType": "technical_report",
      "reviewStatus": "not_reviewed",
      "authors": [
        {
          "name": "GunSpec Research",
          "affiliation": "GunSpec.io"
        }
      ],
      "topic": "load-carriage",
      "methods": [
        "load-carriage"
      ],
      "apiCalls": [
        "/v1/firearms/load-carriage?ids=hk416,fn-scar-l"
      ],
      "status": "published",
      "publishedAt": "2026-09-30T00:00:00.000Z",
      "createdAt": "2026-09-29T00:00:00.000Z",
      "updatedAt": "2026-09-30T00:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "limit": 20,
    "total": 42,
    "totalPages": 3
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.