Age of Empires Official API

Documentation for the official Age of Empires API at ageofempires.com.

API Root

• Production: https://api.ageofempires.com
• Development: https://api-dev.ageofempires.com (for /Poll only)

Endpoints

Main APIs

• API v1 - Version 1 endpoints (bugs, mods)
• API v2 - Version 2 endpoints (leaderboards)
• API v4 - Version 4 endpoints (mods)

Game-Specific APIs

• Age I: DE - Age of Empires: Definitive Edition
• Age II: DE - Age of Empires II: Definitive Edition
• Age III: DE - Age of Empires III: Definitive Edition
• Age IV - Age of Empires IV

Other Endpoints

• Web API - Web-related endpoints
• Poll API - Polling endpoints

Special

Mod Pictures

Example Request

Server Status

Example Request

CountryList

Example Request

errorMessaging

Example Request

wordpressAjax

Example Request

Recorded games

https://aoe.ms/replay/?gameId=<game_id>&profileId=<profile_id>

Example request

Where <profile_id> is the perspective of the recorded game. Basically from which client it was uploaded. Matters for view lock.

API-Endpoints as JSON