Mojang API Reference

Documentation for accessing Minecraft player data.

Base URL

https://mowojang.seraph.si

1. Mojang Compatible Endpoints

Username to UUID

GET /users/profiles/minecraft/{username}

Example cURL

curl -X GET "https://mowojang.seraph.si/users/profiles/minecraft/Steve"

Sample Response

{
  "name": "Steve",
  "id": "853c80ef3c3749fdaa4a93916253d461"
}

User Profile & Textures

GET /session/minecraft/profile/{uuid}

Example cURL

curl -X GET "https://mowojang.seraph.si/session/minecraft/profile/853c80ef3c3749..."

Sample Response

{
  "id": "853c80ef3c3749fdaa4a93916253d461",
  "name": "Steve",
  "properties": [
    {
      "name": "textures",
      "value": "eyJ0aW1lc3Rh..."
    }
  ]
}

2. Simpler Endpoints

Universal Lookup

GET /{username_or_uuid}

Example cURL

curl -X GET "https://mowojang.seraph.si/Steve"

Sample Response

{
  "id": "853c80ef3c3749fdaa4a93916253d461",
  "name": "Steve"
}

Bulk Lookup

POST /

Maximum of 10 profiles per request.

Example cURL

curl -X POST "https://mowojang.seraph.si/" \
     -H "Content-Type: application/json" \
     -d '["Steve", "Alex"]'

Sample Response

[
  {
    "id": "853c80ef3c3749fdaa4a93916253d461",
    "name": "Steve"
  },
  {
    "id": "6169952e181240c483528139402c9535",
    "name": "Alex"
  }
]