Skip to content

GetLegends

GET https://api.brawlhalla.com/v1/static/legends

This request returns data about legends. If called with no parameters, it will return every legend split between two pages.

ParameterTypeRequiredDescription
pageIntegerThe page to return data from.
max_resultsIntegerThe maximum number of results one page can have. The maximum this value can be is 100. If omitted, defaults to 50.
filter_by_idIntegerFilter results by an ID.
filter_by_nameStringFilter results by name.
filter_by_weaponStringFilter results by a weapon.
{
"legends": [
{
"legend_id": 10,
"legend_name": "HATTORI",
"bio_name": "Hattori",
"bio_aka": "Demon Bride",
"bio_quote": "\"The night is freezing\nI sense the spear-bearer nearing.\nIt gets colder still.\"",
"bio_quote_about_attrib": "\"-Verse 761 of Sokan’s One Thousand Verses on the Demon Hattori\"",
"bio_quote_from": "\"A half-demon ninja who sold her soul to the devil? Well that’s one, frankly rather negative, way of looking at it.\"",
"bio_quote_from_attrib": "\"-Hattori \"",
"bio_text": "Young Hattori was so gifted with the sword that the Emperor offered a prize of one thousand horses to anyone who could defeat her. For years, new warriors came to court every day only to be defeated. But on the day the Demon Kagima arrived to challenge her, Hattori sensed his malevolent power and fled. Enraged, the Demon kidnapped Hattori’s three sisters and carried them away to his island kingdom.\nHorrified by the consequences of her actions, Hattori built a boat out of reeds and pursued the Demon. She was lost at sea until a stork lord showed her the passages between the twilight and the night to the Demon’s realm. There Hattori found a bizarre world of talking stones and eight-armed ferrymen. In the City of the Onyx Castle, she met Kagima’s own brother, who offered to give Hattori his strength to defeat his brother, in return for her hand in marriage.\nTrue to his word, the Demon exchanged his own blood with Hattori’s, and Hattori slew Kagima and freed her sisters. She became Queen of the Island Kingdom, but the demon blood burned in her. It drove Hattori to wander the twilight passages until she discovered Valhalla. Through the eternal tournament, Hattori slakes the lust for battle that threatens to consume her.",
"bot_name": "Bottori",
"weapon_one": "Sword",
"weapon_two": "Spear",
"strength": 4,
"dexterity": 6,
"defense": 4,
"speed": 8
},
{
"legend_id": 13,
"legend_name": "THATCH",
"bio_name": "Thatch",
"bio_aka": "The Madman of Barbados",
"bio_quote": "“An old sea shanty tells the tale of a buccaneer who went mad drinking gunpowder and grog. Every time he sailed into battle, he’d set his own ship aflame so there could be no retreat. I forget how it goes, but the chorus includes the phrase 'high turnover rate.'”",
"bio_quote_about_attrib": "\"-Oldish Pete, proprietor of The Anchor and Pistol\"",
"bio_quote_from": "\"Ye call this grog? I can still feel me face.\"",
"bio_quote_from_attrib": "\"-Thatch, to a stuffed deer head over the bar\"",
"bio_text": "Thatch won his ship from the devil with the devil’s own double-headed coin, and aboard it he wreaked more havoc than any pirate before or since. His love of black powder and obsession with setting the world aflame combined to sink hundreds of ships, sack dozens of ports, and prematurely erupt at least two volcanoes.\nThatch’s ship had so many ghosts, they haunted in shifts. He plays his favorite drinking game, “Drink every time Thatch has a beard.” He claims to be married to the sea, and has a marriage license to prove it. He has a face only a mother could love if he hadn’t made her walk the plank.\nFor Thatch, the Tournament is a paradise of chaos and fire, but even that doesn’t slake his thirst for mayhem. He aids in Vraxx’s schemes to conquer Valhalla out of sheer bloody-mindedness, and when bored will lay deadly traps he calls ‘pranks’ for his fellow Legends. He sneaks out at night to dig holes, knowing the gods must have buried treasure somewhere.",
"bot_name": "Thatchomaton",
"weapon_one": "Sword",
"weapon_two": "Pistol",
"strength": 7,
"dexterity": 5,
"defense": 3,
"speed": 7
}
],
"total_pages": 2
}
ParameterTypeRequiredDescription
legend_idInteger✔️The ID of the legend.
legend_nameString✔️The database name of the legend.
bio_nameString✔️The name of the legend.
bio_akaString✔️The legend’s “Also Known As” title.
bio_quoteString✔️The legend’s first quotation.
bio_quote_about_attribString✔️The attribution of the first quotation.
bio_quote_fromString✔️The legend’s second quotation.
bio_quote_from_attribString✔️The attribution of the second quotation.
bio_textString✔️The legend’s full biography.
bot_nameString✔️The player name the legend uses when assigned as a bot.
weapon_oneString✔️The legend’s first listed weapon.
weapon_twoString✔️The legend’s second listed weapon.
strengthInteger✔️The legend’s strength stat.
dexterityInteger✔️The legend’s dexterity stat.
defenseInteger✔️The legend’s defense stat.
speedInteger✔️The legend’s speed stat.
total_pagesInteger✔️The total number of pages your search obtained.