Bosses

Boss encounter data: stats, drops, phases, wiki lore descriptions, and campaign flags.

List bosses

GET /v1/bloodborne/bosses?page=1&page_size=2

Supports pagination. See [Pagination](/api/pagination/).

Try it

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

Example response

200 OK

{
  "data": [
    {
      "slug": "amygdala",
      "name": "Amygdala",
      "is_optional": true,
      "is_chalice": false,
      "location_slug": "nightmare-frontier"
    },
    {
      "slug": "blood-starved-beast",
      "name": "Blood-starved Beast",
      "is_optional": true,
      "is_chalice": false,
      "location_slug": "old-yharnam"
    }
  ],
  "meta": { "page": 1, "page_size": 2, "total": 22 }
}

Get boss by slug

GET /v1/bloodborne/bosses/father-gascoigne

Detail includes a lore description (from the wiki) plus stats, drops, and phases. Replace father-gascoigne with any boss slug from the list response.

Try it

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/bosses/father-gascoigne"

Example response

200 OK

{
  "data": {
    "slug": "father-gascoigne",
    "name": "Father Gascoigne",
    "is_optional": false,
    "is_chalice": false,
    "location_slug": "central-yharnam",
    "description": "A lone person standing in a graveyard among the whirling ashes, he's bloodied hunter. He looks like an experienced veteran, but details are unknown. The Dingy scarf is a Holy Shawl and symbol of the Healing Church, from which Gascoigne would eventually part ways. \"Father\" is a title used for clerics in a foreign land, and there is no such rank in the Healing Church. Gascoigne exhibits great strength in battle and has an imposing height, towering over the Hunter. He is dressed in a typical attire of Healing Church.",
    "wiki_url": "https://www.bloodborne-wiki.com/2015/03/father-gascoigne.html",
    "campaign": "main_story",
    "is_dlc": false,
    "is_required": true,
    "is_interruptible": true,
    "lamp": "Tomb of Oedon",
    "hp": 2031,
    "blood_echoes": 3200,
    "drops": [{ "name": "Oedon Tomb Key", "quantity": null }],
    "phases": [
      { "phase_index": 0, "name": "Human", "notes": null },
      { "phase_index": 1, "name": "Beast", "notes": null }
    ]
  }
}

Not found (404)

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

{notFoundExample}