Locations

Areas, lamps, connections, and bosses embedded on location detail.

List locations

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

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

Try it

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

Example response

200 OK

{
  "data": [
    {
      "slug": "central-yharnam",
      "name": "Central Yharnam",
      "region": "Yharnam Headstone",
      "parent_slug": null,
      "connected_slugs": ["cathedral-ward", "iosefkas-clinic"],
      "boss_slugs": ["cleric-beast", "father-gascoigne"]
    }
  ],
  "meta": { "page": 1, "page_size": 1, "total": 21 }
}

Get location by slug

GET /v1/bloodborne/locations/central-yharnam

Detail includes full boss embeds (stats, drops, phases) for bosses in this area.

Try it

curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/locations/central-yharnam"

Example response

200 OK

{
  "data": {
    "slug": "central-yharnam",
    "name": "Central Yharnam",
    "region": "Yharnam Headstone",
    "parent_slug": null,
    "connected_slugs": ["cathedral-ward", "iosefkas-clinic"],
    "boss_slugs": ["cleric-beast", "father-gascoigne"],
    "headstone": "yharnam",
    "time_of_day": ["day", "evening", "night", "blood_moon"],
    "lamps": ["Central Yharnam", "Great Bridge", "Tomb of Oedon"],
    "insight_total": 8,
    "bosses": [
      {
        "slug": "cleric-beast",
        "name": "Cleric Beast",
        "is_optional": true,
        "hp": 3015,
        "blood_echoes": 4000,
        "drops": [{ "name": "Sword Hunter Badge", "quantity": null }],
        "phases": []
      },
      {
        "slug": "father-gascoigne",
        "name": "Father Gascoigne",
        "is_optional": false,
        "hp": 2031,
        "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/locations/unknown-area-xyz"

{notFoundExample}