Mojang API Reference

Documentation for accessing Minecraft player data.

Base URL

https://mowojang.seraph.si 📋 Copy

1. Mojang Compatible Endpoints

Username to UUID 🔗 Link

GET /users/profiles/minecraft/{username}

Example cURL 
curl -X GET "https://mowojang.seraph.si/users/profiles/minecraft/Steve"
JavaScript (Fetch) 
fetch('https://mowojang.seraph.si/users/profiles/minecraft/Steve')
  .then(res => res.json())
  .then(data => console.log(data));
Python (requests) 
import requests

response = requests.get('https://mowojang.seraph.si/users/profiles/minecraft/Steve')
data = response.json()
print(data)
Java (HttpClient) 
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
	.uri(URI.create("https://mowojang.seraph.si/users/profiles/minecraft/Steve"))
	.build();
String response = client.send(request, BodyHandlers.ofString()).body();
Sample Response 
{
  "name": "Steve",
  "id": "853c80ef3c3749fdaa4a93916253d461"
}

User Profile & Textures 🔗 Link

GET /session/minecraft/profile/{uuid}

Example cURL 
curl -X GET "https://mowojang.seraph.si/session/minecraft/profile/853c80ef3c3749fdaa4a93916253d461"
JavaScript (Fetch) 
fetch('https://mowojang.seraph.si/session/minecraft/profile/853c80ef3c3749fdaa4a93916253d461')
  .then(res => res.json())
  .then(data => console.log(data));
Python (requests) 
import requests

response = requests.get('https://mowojang.seraph.si/session/minecraft/profile/853c80ef3c3749fdaa4a93916253d461')
data = response.json()
print(data)
Java (HttpClient) 
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
	.uri(URI.create("https://mowojang.seraph.si/session/minecraft/profile/853c80ef3c3749fdaa4a93916253d461"))
	.build();
String response = client.send(request, BodyHandlers.ofString()).body();
Sample Response 
{
  "id": "853c80ef3c3749fdaa4a93916253d461",
  "name": "Steve",
  "properties": [
	{
	  "name": "textures",
	  "value": "eyJ0aW1lc3Rh..."
	}
  ]
}

2. Simpler Endpoints

Universal Lookup 🔗 Link

GET /{username_or_uuid}

Example cURL 
curl -X GET "https://mowojang.seraph.si/Steve"
JavaScript (Fetch) 
fetch('https://mowojang.seraph.si/Steve')
  .then(res => res.json())
  .then(data => console.log(data));
Python (requests) 
import requests

response = requests.get('https://mowojang.seraph.si/Steve')
data = response.json()
print(data)
Java (HttpClient) 
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
	.uri(URI.create("https://mowojang.seraph.si/Steve"))
	.build();
String response = client.send(request, BodyHandlers.ofString()).body();
Sample Response 
{
  "id": "853c80ef3c3749fdaa4a93916253d461",
  "name": "Steve"
}

Bulk Lookup 🔗 Link

POST /

Maximum of 10 profiles per request.

Example cURL 
curl -X POST "https://mowojang.seraph.si/" \
	 -H "Content-Type: application/json" \
	 -d '["Steve", "Alex"]'
JavaScript (Fetch) 
fetch('https://mowojang.seraph.si/', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(['Steve', 'Alex'])
})
  .then(res => res.json())
  .then(data => console.log(data));
Python (requests) 
import requests
import json

response = requests.post(
	'https://mowojang.seraph.si/',
	headers={'Content-Type': 'application/json'},
	data=json.dumps(['Steve', 'Alex'])
)
data = response.json()
print(data)
Java (HttpClient) 
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
	.uri(URI.create("https://mowojang.seraph.si/"))
	.header("Content-Type", "application/json")
	.POST(HttpRequest.BodyPublishers.ofString("[\"Steve\", \"Alex\"]"))
	.build();
String response = client.send(request, BodyHandlers.ofString()).body();
Sample Response 
[
  {
	"id": "853c80ef3c3749fdaa4a93916253d461",
	"name": "Steve"
  },
  {
	"id": "6169952e181240c483528139402c9535",
	"name": "Alex"
  }
]