Characters

A Character is an individual within the Ice And Fire universe.

Name	Type	Description
url	string	The hypermedia URL of this resource
name	string	The name of this character
gender	string	The gender of this character.
culture	string	The culture that this character belongs to.
born	string	Textual representation of when and where this character was born.
died	string	Textual representation of when and where this character died.
titles	array of strings	The titles that this character holds.
aliases	array of strings	The aliases that this character goes by.
father	string	The character resource URL of this character's father.
mother	string	The character resource URL of this character's mother.
spouse	string	An array of Character resource URLs that has had a POV-chapter in this book.
allegiances	array of strings	An array of House resource URLs that this character is loyal to.
books	array of strings	An array of Book resource URLs that this character has been in.
povBooks	array of strings	An array of Book resource URLs that this character has had a POV-chapter in.
tvSeries	array of strings	An array of names of the seasons of Game of Thrones that this character has been in.
playedBy	array of strings	An array of actor names that has played this character in the TV show Game Of Thrones.

List all characters

Request

$ curl "https://www.anapioficeandfire.com/api/characters"

Response

[
    {
        "aliases": [
            "The Daughter of the Dusk"
        ],
        "allegiances": [],
        "books": [
            "https://www.anapioficeandfire.com/api/books/5"
        ],
        "born": "",
        "culture": "Braavosi",
        "died": "",
        "father": "",
        "mother": "",
        "name": "",
        "playedBy": [],
        "povBooks": [],
        "spouse": "",
        "titles": [],
        "tvSeries": [],
        "url": "https://www.anapioficeandfire.com/api/characters/1"
    },
    {
        "aliases": [
            "Hodor"
        ],
        "allegiances": [
            "https://www.anapioficeandfire.com/api/houses/362"
        ],
        "books": [
            "https://www.anapioficeandfire.com/api/books/1"
        ],
        "born": "",
        "culture": "",
        "died": "",
        "father": "",
        "mother": "",
        "name": "",
        "playedBy": [
            "Kristian Nairn"
        ],
        "povBooks": [],
        "spouse": "",
        "titles": [],
        "tvSeries": [
            "Season 1",
            "Season 2",
            "Season 3",
            "Season 4"
        ],
        "url": "https://www.anapioficeandfire.com/api/characters/2"
    }
]

Filtering characters

You can also include filter parameters in your request to the characters endpoint by including parameters in the query string.

Parameter	Type	Result
name	string	Characters with the given name are included in the response.
gender	string	Characters with the given gender are included in the response.
culture	string	Characters with the given culture are included in the response.
born	string	Characters that were born this given year are included in the response.
died	string	Characters that died this given year are included in the response.
isAlive	boolean	Characters that are alive or dead (depending on the value) are included in the response.

Get specific character

Request

$ curl "https://www.anapioficeandfire.com/api/characters/823"

Response

{
    "aliases": [
        "Littlefinger"
    ],
    "allegiances": [
        "https://www.anapioficeandfire.com/api/houses/10",
        "https://www.anapioficeandfire.com/api/houses/11"
    ],
    "books": [
        "https://www.anapioficeandfire.com/api/books/1"
    ],
    "born": "In 268 AC, at the Fingers",
    "culture": "Valemen",
    "died": "",
    "father": "",
    "mother": "",
    "name": "Petyr Baelish",
    "playedBy": [
        "Aidan Gillen"
    ],
    "povBooks": [],
    "spouse": "https://www.anapioficeandfire.com/api/characters/688",
    "titles": [
        "Master of coin (formerly)",
        "Lord Paramount of the Trident",
        "Lord of Harrenhal",
        "Lord Protector of the Vale"
    ],
    "tvSeries": [
        "Season 1",
        "Season 2",
        "Season 3",
        "Season 4",
        "Season 5"
    ],
    "url": "https://www.anapioficeandfire.com/api/characters/823"
}