Papers

Get a research paper

Returns one published research paper, including its full body, its authors, its review status and the API calls that reproduce its figures.

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

get/v1/papers/{slug}

Request

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

Path parameters

slugstring required

Paper slug

Response

Get a research paper

successboolean required

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

Example response

{
  "success": true,
  "data": {
    "paper": {
      "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"
    }
  }
}

Changes

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