Items

Consumables, key items, arcane tools, and multiplayer items.

List items

GET /v1/bloodborne/items?page=1&page_size=1&family=consumable

Optional query: family — consumable, key_item, arcane_tool, multiplayer.

Try it

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

Example response

200 OK

{
  "data": [
    {
      "slug": "blood-vial",
      "name": "Blood Vial",
      "family": "consumable",
      "subcategory": "recovery",
      "is_dlc": false
    }
  ],
  "meta": { "page": 1, "page_size": 1, "total": 113 }
}

Get item by slug

GET /v1/bloodborne/items/blood-vial

Detail includes effect, sold_by merchants, and acquisition sources.

Try it

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/items/blood-vial"

Example response

200 OK

{
  "data": {
    "slug": "blood-vial",
    "name": "Blood Vial",
    "family": "consumable",
    "subcategory": "recovery",
    "is_dlc": false,
    "effect": "Blood Vial",
    "sold_by": ["bath-messengers", "chalice-bath-messengers"],
    "acquisition": [
      {
        "kind": "treasure",
        "location_slug": "central-yharnam",
        "boss_slug": null,
        "npc_slug": null,
        "notes": "Common pickup in Yharnam"
      }
    ]
  }
}

Not found (404)

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

{notFoundExample}