Weapons

Trick weapons and firearms with scaling, requirements, forms, and gem variants.

List weapons

GET /v1/bloodborne/weapons?page=1&page_size=1&category=trick_weapon

Optional query: category (e.g. trick_weapon, firearm). Supports pagination.

Try it

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/weapons?page=1&page_size=1&category=trick_weapon"

Example response

200 OK

{
  "data": [
    {
      "slug": "saw-cleaver",
      "name": "Saw Cleaver",
      "category": "trick_weapon",
      "variants": [
        { "kind": "normal", "gems": ["radial", "radial", "waning"] }
      ],
      "forms": [
        { "slug": "untransformed", "name": "Untransformed", "form_kind": "untransformed", "sort_order": 0 }
      ]
    }
  ],
  "meta": { "page": 1, "page_size": 1, "total": 43 }
}

Get weapon by slug

GET /v1/bloodborne/weapons/saw-cleaver

Full detail includes all forms (damage, scaling per form) and variants (gem slots).

Try it

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/weapons/saw-cleaver"

Example response

200 OK

{
  "data": {
    "slug": "saw-cleaver",
    "name": "Saw Cleaver",
    "category": "trick_weapon",
    "tags": ["serrated"],
    "is_dlc": false,
    "requirements": { "strength": 8, "skill": 7, "blood_tinge": null, "arcane": null },
    "scaling": { "strength": "D", "skill": "E", "blood_tinge": "-", "arcane": "D" },
    "variants": [
      { "kind": "normal", "gems": ["radial", "radial", "waning"], "notes": null }
    ],
    "forms": [
      {
        "slug": "untransformed",
        "name": "Untransformed",
        "form_kind": "untransformed",
        "attack_physical": 90,
        "scaling": { "strength": "D", "skill": "E", "blood_tinge": "-", "arcane": "D" }
      }
    ]
  }
}

Not found (404)

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/weapons/unknown-weapon-xyz"

{notFoundExample}