Armor
Attire pieces (head, chest, hands, legs) and armor sets from the Bloodborne wiki armor index. Defense stats are populated incrementally; null means not curated yet.
Armor pieces
List armor
GET /v1/bloodborne/armor?page=1&page_size=2
Optional query: slot (head, chest, hands, legs) or set_slug. Supports pagination.
Try it
curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/armor?page=1&page_size=2" Example response
200 OK
{
"data": [
{
"slug": "hunter-hat",
"name": "Hunter Hat",
"slot": "head",
"set_slug": "hunter-set",
"variant_label": null,
"is_dlc": false
},
{
"slug": "hunter-garb",
"name": "Hunter Garb (Cape)",
"slot": "chest",
"set_slug": "hunter-set",
"variant_label": "cape",
"is_dlc": false
}
],
"meta": { "page": 1, "page_size": 2, "total": 124 }
} Get armor by slug
GET /v1/bloodborne/armor/hunter-garb
Detail includes defense breakdown, equip load, sold_by, and acquisition when available.
Try it
curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/armor/hunter-garb" Example response
200 OK
{
"data": {
"slug": "hunter-garb",
"name": "Hunter Garb (Cape)",
"slot": "chest",
"set_slug": "hunter-set",
"variant_label": "cape",
"is_dlc": false,
"description": null,
"wiki_url": "http://www.bloodborne-wiki.com/2015/03/hunter-garb.html",
"defense": {
"physical": 110,
"blunt": 110,
"thrust": 80,
"blood": 110,
"arcane": 40,
"fire": 110,
"bolt": 70,
"slow_poison": 17,
"rapid_poison": 33,
"frenzy": 48,
"beasthood": 44
},
"equip_load": 44,
"sold_by": [],
"acquisition": []
}
} Not found (404)
curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/armor/unknown-armor-xyz"
{notFoundExample}Armor sets
List armor sets
GET /v1/bloodborne/armor-sets?page=1&page_size=2
Supports pagination.
Try it
curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/armor-sets?page=1&page_size=2" Example response
200 OK
{
"data": [
{ "slug": "hunter-set", "name": "Hunter Set", "is_dlc": false },
{ "slug": "cainhurst-set", "name": "Cainhurst Set", "is_dlc": false }
],
"meta": { "page": 1, "page_size": 2, "total": 26 }
} Get armor set by slug
GET /v1/bloodborne/armor-sets/hunter-set
Returns piece_slugs for all pieces in the set.
Try it
curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/armor-sets/hunter-set" Example response
200 OK
{
"data": {
"slug": "hunter-set",
"name": "Hunter Set",
"is_dlc": false,
"wiki_url": "http://www.bloodborne-wiki.com/2015/03/hunter-set.html",
"piece_slugs": ["hunter-hat", "hunter-garb", "hunter-gloves", "hunter-trousers"]
}
} Set not found (404)
curl -s -H "X-API-Key: YOUR_API_KEY" "https://www.souls-api.com/v1/bloodborne/armor-sets/unknown-set-xyz"
{notFoundExample}