You're reading about version 1 of the API which has since been superseded by version 3. There are breaking changes which make version 2 unusable, this documentation remains for historic reasons only.
There is one API endpoint only accessible via HTTP GET. The account is not case sensitive and will be trimmed of leading or trailing white spaces. The account should always be URL encoded.
The response is simply an alphabetically sorted string array of pwned websites for the account in JSON format:
The sample can be invoked in the browser by clicking here or reconstructed in your tool of choice as follows:
GET HTTP/1.1 https://haveibeenpwned.com/api/breachedaccount/test%40example.com
HTTP/1.1 200 OK ["Adobe","Gawker","Stratfor"]
Response values may not be suitable for user-facing displays. They are stable (will not change in the future) and are sorted alphabetically. Current breach values are:
000webhost, 126, 17Media, 17173, 2844Breaches, 2fast4u, 500px, 7k7k, 8fit, 8tracks, Abandonia, AbuseWithUs, AcneOrg, Adapt, Adobe, AdultFriendFinder, AdultFanFiction, AerServ, AhaShare, AIType, Aipai, AKP, Ancestry, AndroidForums, AnimePlanet, Animoto, AntiPublic, Apollo, Appartoo, ArmorGames, ArmyForceOnline, Artvalue, AshleyMadison, AstroPID, Aternos, AtlasQuantum, Autocentrum, Avast, B2BUSABusinesses, BabyNames, Badoo, BannerBit, BattlefieldHeroes, BeautifulPeople, Bell, Bell2017, Bestialitysextaboo, BigMoneyJobs, BinWeevils, BiohackMe, BTSec, BitcoinTalk, Bitly, BitTorrent, BlackHatWorld, BlackSpigotMC, BlankMediaGames, Bolt, BombujEu, Bookmate, BotOfLegends, Boxee, Brazzers, BTCE, Bukalapak, BulgarianNationalRevenueAgency, BusinessAcumen, CafeMom, CafePress, CannabisForum, Canva, CashCrate, CDProjektRed, CheapAssGamer, Chegg, CivilOnline, ClashOfKings, ClixSense, CloudPets, ClubPenguinRewritten, ClubPenguinRewrittenJul2019, Coachella, Coinmama, Collection1, Comcast, COMELEC, CouponMomAndArmorGames, CrackCommunity, CrackedTO, CrackingForum, Creative, CrimeAgencyVBulletin, CrossFire, D3scene, DaFont, Dailymotion, Dangdang, DaniWeb, DataAndLeads, DataEnrichment, DataCamp, DemonForums, devkitPro, DietCom, Digimon, Disqus, DLH, Dodonew, Dominos, Dropbox, Dubsmash, DDO, Duowan, DVDShopCH, EatStreet, Edmodo, Elance, ElasticsearchSalesLeads, Emuparadise, EpicGames, EpicNPC, Eroticy, Estonia, eThekwiniMunicipality, Ethereum, Evermotion, EverybodyEdits, Evite, Evony, Exactis, Experian, ExploitIn, VINs, EyeEm, Facepunch, FaceUP, WhiteRoom, FashionFantasyGame, FFShrine, FlashFlashRevolution, FlashFlashRevolution2019, Flashback, Fling, FLVS, Forbes, ForumCommunity, FoxyBingo, FreedomHostingII, FreshMenu, Fridae, Funimation, FunnyGames, FurAffinity, Gaadi, GamerzPlanet, GameSalad, GameTuts, Gamigo, Gawker, GeekedIn, GFAN, GoldSilver, gPotato, GTAGaming, Playgar, HackForums, HackingTeam, HauteLook, HealthNowNetworks, Hemmakvall, Hemmelig, HeroesOfGaia, HeroesOfNewerth, HIAPK, HLTV, HongFire, HookersNL, HoundDawgs, Houzz, HTHStudios, Hub4Tech, iDressup, ILikeCheats, iMesh, imgur, Insanelyi, Intelimost, Interpals, iPmart, ixigo, JobStreet, JoomlArt, JustDate, KayoMoe, Kickstarter, Kimsufi, KiwiFarms, KMRU, KnownCircle, Knuddels, Lanwar, Lastfm, LeagueOfLegends, Leet, Lifeboat, LightsHope, LinkedIn, LinuxForums, LinuxMint, LittleMonsters, LizardSquad, Lookbook, LOTR, LoungeBoard, LuminPDF, LyricsMania, MacForums, Mac-Torrents, MailRu, MajorGeeks, MallCZ, Malwarebytes, MangaTraders, MangaFox, Mappery, MasterDeeds, MastercardPricelessSpecials, Mate1, MCBans, MDPI, MindJolt, MinecraftPocketEditionForum, MinecraftWorldMap, Minefield, Minehut, MoDaCo, ModernBusinessSolutions, MoneyBookers, MoreleNet, MortalOnline, MPGH, MrExcel, mSpy, MuslimDirectory, MuslimMatch, MyFHA, MyFitnessPal, MyHeritage, myRepoSpace, MySpace, MyVidster, NapsGear, NaughtyAmerica, NemoWeb, Neopets, NetEase, Neteller, Netlog, NetProspex, Netshoes, NextGenUpdate, NexusMods, Nihonomaru, Nival, NonNudeGirls, Nulled, OGUsers, OnlinerSpambot, Onverse, OpenCSGO, OrdineAvvocatiDiRoma, OVH, OwnedCore, PaddyPower, Patreon, PayAsUGym, Pemiblanc, PHPFreaks, PixelFederation, piZap, Plex, Pokebip, PokemonCreed, PokemonNegro, PoliceOne, Poshmark, Powerbot, ProgrammingForums, PS3Hax, PSPISO, PSX-Scene, QatarNationalBank, QIP, QuantumBooter, QuinStreet, R2-2017, R2Games, Rambler, Rankwatch, RbxRocks, RealEstateMogul, BlueSnapRegpack, RetinaX, Reverb-Nation, RiverCityMedia, Roll20, RosebuttBoard, RussianAmerica, SaverSpy, SCDailyPhoneSpamList, Seedpeer, Sephora, ServerPact, ShareThis, SHEIN, Shotbow, SkTorrent, Smogon, Snail, Snapchat, SocialEngineered, SIAE, Sony, Soundwave, SpecialKSpamList, Spirol, SpyFone, Staminus, StarNet, SterKinekor, StockX, Stratfor, StreetEasy, StrongholdKingdoms, SumoTorrent, SvenskaMagic, SweClockers, Taobao, Taringa, Solomid, Technic, TRAI, Teracod, Tesco, TGBUS, TheCandidBoard, TheFappening, TheFlyOnTheWall, TheTVDB, ThisHabboForum, Tianya, Ticketfly, ToonDoo, TorrentInvites, TrikSpamBotnet, Trillian, TruckersMP, Tumblr, Uiggy, IGF, UnderworldEmpire, UnrealEngine, uTorrent, uuu9, VBulletin, Vedantu, VerificationsIO, Verified, VictoryPhones, ViewFines, VK, VNG, Vodafone, VoidTO, VTech, VTightGel, Wanelo, WarInc, Warframe, Warmane, WeHeartIt, Whitepages, WHMCS, WienerBuchereien, WifeLovers, WIIUISO, WildStar, Win7Vista, Wishbone, WPSandbox, WPT, xat, Xbox360ISO, Xbox-Scene, xHamster, Xiaomi, XKCD, XPGameSaves, XSplit, Yahoo, Yandex, Yatra, Youku, YouNow, YouPorn, YouveBeenScraped, Zhenai, Zomato, Zoosk, Zooville, Parapa, SprashivaiRu
Semantic HTTP response codes are used to indicate the status of the search:
|200||Ok — everything worked and there's a string array of pwned sites for the account|
|400||Bad request — the account does not comply with an acceptable format (i.e. it's an empty string)|
|404||Not found — the account could not be found and has therefore not been pwned|
The API must be invoked over HTTPS. Any requests over HTTP will result in a 301 response with a redirect to the same path on the secure scheme.
CORS is fully supported for all origins — you can hit the API from websites on any other domain.
There isn't any.
There isn't any of that either.
There's not much point; if you want to build up a treasure trove of pwned email addresses or usernames, go and download the dumps (they're all just a Google search away) and save yourself the hassle and time of trying to enumerate an API one account at a time.