Mayor - SkyTools API

All API requests require an X-API-Key header. Get your key from the Developer Dashboard.

curl -H "X-API-Key: sk_your_key_here" \
  "https://api.skytools.app/v1/..."

See Authentication for details on key formats and tier limits.

GET /v1/mayor

Returns the current SkyBlock mayor, their perks, and active election data. Cache: 5 minutes

Query parameters

None.

Examples

curl -H "X-API-Key: sk_your_key_here" \
  "https://api.skytools.app/v1/mayor"

const response = await fetch("https://api.skytools.app/v1/mayor", {
  headers: { "X-API-Key": "sk_your_key_here" },
});
const { data } = await response.json();
console.log(`Current mayor: ${data.mayor.name}`);
data.mayor.perks.forEach((perk) => console.log(`  - ${perk.name}: ${perk.description}`));

import requests

response = requests.get(
    "https://api.skytools.app/v1/mayor",
    headers={"X-API-Key": "sk_your_key_here"},
)
mayor = response.json()["data"]["mayor"]
print(f"Current mayor: {mayor['name']}")
for perk in mayor["perks"]:
    print(f"  - {perk['name']}: {perk['description']}")

Response

{
  "success": true,
  "data": {
    "mayor": {
      "name": "Diana",
      "key": "diana",
      "perks": [
        {
          "name": "Lucky!",
          "description": "Gain +25 Pet Luck"
        },
        {
          "name": "Mythological Ritual",
          "description": "Mayor Diana grants the ability to use a Griffin Pet..."
        }
      ]
    },
    "current": { ... },
    "election": { ... }
  },
  "meta": { "cached": false, "api_version": "v1" }
}

Field	Type	Description
`mayor.name`	string	Mayor’s display name
`mayor.key`	string	Internal mayor key
`mayor.perks`	array	Active perks for this mayor
`mayor.perks[].name`	string	Perk display name
`mayor.perks[].description`	string	Perk effect description
`current`	object	Current election cycle data
`election`	object	Election candidate and vote data

GET /v1/mayor/history

Returns past mayors from the database, ordered by most recent first. Cache: 5 minutes

Query parameters

Parameter	Type	Default	Description
`limit`	integer	`24`	Number of results (1–100)

Examples

curl -H "X-API-Key: sk_your_key_here" \
  "https://api.skytools.app/v1/mayor/history?limit=10"

const response = await fetch(
  "https://api.skytools.app/v1/mayor/history?limit=10",
  { headers: { "X-API-Key": "sk_your_key_here" } }
);
const { data } = await response.json();
data.history.forEach((mayor) => {
  console.log(`${mayor.name}: ${mayor.started_at} — ${mayor.ended_at}`);
});

Response

{
  "success": true,
  "data": {
    "history": [
      {
        "name": "Diana",
        "key": "diana",
        "perks": [
          { "name": "Lucky!", "description": "Gain +25 Pet Luck" }
        ],
        "started_at": "2026-02-01T00:00:00Z",
        "ended_at": "2026-02-05T00:00:00Z"
      }
    ]
  },
  "meta": { "cached": true, "api_version": "v1" }
}

Field	Type	Description
`history[].name`	string	Mayor name
`history[].key`	string	Internal mayor key
`history[].perks`	array	Perks that were active during their term
`history[].started_at`	string	ISO 8601 term start timestamp
`history[].ended_at`	string	ISO 8601 term end timestamp