Search characters by name / house

Code snippets

curl "https://api.oanor.com/harrypotter-api/v1/character" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/harrypotter-api/v1/character", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/harrypotter-api/v1/character");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/harrypotter-api/v1/character",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "page": 1,
        "count": 2,
        "total": 2,
        "page_size": 20,
        "characters": [
            {
                "id": "unidentified-gryffindor-fifth-year-who-congratulated-harry-potter",
                "born": "Between 1 September 1976 and 31 August 1977",
                "died": null,
                "jobs": [],
                "name": "Gryffindor fifth-year who congratulated Harry Potter",
                "wiki": "https://harrypotter.fandom.com/wiki/Unidentified_Gryffindor_fifth-year_who_congratulated_Harry_Potter",
                "house": "Gryffindor",
                "image": null,
                "wands": [],
                "gender": null,
                "titles": [],
                "boggart": null,
                "species": "Human",
                "ancestry": null,
                "animagus": null,
                "patronus": null,
                "eye_color": null,
                "hair_color": null,
                "alias_names": [],
                "nationality": "British or Irish",
                "blood_status": null,
                "family_members": []
            },
            {
                "id": "unidentified-death-eater-who-was-stunned-by-harry-potter",
                "born": null,
                "died": null,
                "jobs": [],
                "name": "Unidentified Death Eater who was Stunned by Harry Potter",
                "wiki": "https://harrypotter.fandom.com/wiki/Unidentified_Death_Eater_who_was_Stunned_by_Harry_Potter",
                "house": null,
                "image": null,
                "wands": [],
                "gender": "Male",
                "titles": [],
                "boggart": null,
                "species": "Human",
                "ancestry": null,
                "animagus": null,
                "patronus": "None",
                "eye_color": null,
                "hair_color": "Black",
                "alias_names": [],
                "nationality": null,
                "blood_status": "Pure-blood or half-blood",
                "family_members": []
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:31.551Z",
        "request_id": "2b89200d-da7a-45fd-a2c1-b5b463af24b1"
    },
    "status": "ok",
    "message": "Character retrieved",
    "success": true
}