Runes

Caryll runes and oath runes with tiers and acquisition.

List runes

GET /v1/bloodborne/runes?page=1&page_size=1

Optional query: kind — caryll or oath. Supports pagination.

Try it

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

Example response

200 OK

{
  "data": [
    {
      "slug": "arcane-lake",
      "name": "Arcane Lake",
      "kind": "caryll",
      "is_dlc": false
    }
  ],
  "meta": { "page": 1, "page_size": 1, "total": 27 }
}

Get rune by slug

GET /v1/bloodborne/runes/arcane-lake

Detail includes effect tiers and acquisition entries.

Try it

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/runes/arcane-lake"

Example response

200 OK

{
  "data": {
    "slug": "arcane-lake",
    "name": "Arcane Lake",
    "kind": "caryll",
    "is_dlc": false,
    "effect": "+5%; +7%; +10%",
    "tiers": [
      { "tier": 1, "effect_bonus": "+5%" },
      { "tier": 2, "effect_bonus": "+7%" },
      { "tier": 3, "effect_bonus": "+10%" }
    ],
    "covenant_slug": null,
    "special_note": "A \"Lake\" rune. Increases arcane damage reduction",
    "acquisition": [
      { "kind": "treasure", "location_slug": "yahargul-unseen-village", "source": "Yahar'gul, Unseen Village" }
    ]
  }
}

Not found (404)

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

{notFoundExample}