TheAltening Logo

Documentation

TheAltening Web API

Basics

Base URL, authentication, and response format

Base URL
https://api.thealtening.com/v2/
Method
All requests use GET with query parameters.
Authentication
Include your API key using the key query parameter. You can find it on the Account page.
Access
API access is available on any paid plan.
Format
Responses are JSON objects or arrays, depending on the endpoint.
Authenticated request
https://api.thealtening.com/v2/generate?key=api-1234-1234-1234

Quick start

Generate a token in a few lines

The most common integration is to collect a user’s API key, call /generate, then pass the returned token into your launcher, bot, or account manager.

1

API Key

Use the key from the Account page.

2

Call /generate

Request a fresh token with a GET call.

3

Parse JSON

Read token, username, skin, and limit.

JavaScript
const response = await fetch(
  'https://api.thealtening.com/v2/generate?key=api-1234-1234-1234&info=true'
)

const alt = await response.json()
console.log(alt.token, alt.username)

Endpoints

Available API calls

Each endpoint uses the same base URL. Premium-only endpoints return 403 Forbidden when the plan is not eligible.

GETAccess · Paid plan required

Generate a token

Returns a token you can pass directly into your launcher, bot, or alt manager.

GET/generate?key=<api-key>[&info=true]

If the account daily limit has been reached, the generated tokens will loop from the beginning.

Parameters

keyRequired

Your TheAltening API key from the Account page.

info

Optional. Set to true to include extra account info when available.

The info object is only included when info=true is present and may be empty when no extra properties are available.
Sample request
https://api.thealtening.com/v2/generate?key=<api-key>
With extra info
https://api.thealtening.com/v2/generate?key=<api-key>&info=true
Response
{
  "token": "example@alt.com",
  "password": "anything",
  "username": "Examp**",
  "limit": false,
  "skin": "555...",
  "info": {
    "hypixel.lvl": "10",
    "hypixel.rank": "MVP",
    "mineplex.lvl": "10",
    "mineplex.rank": "LEGEND",
    "labymod.cape": "true",
    "5zig.cape": "true"
  }
}
Skin CDN helper
https://cdn.thealtening.com/skins/body/<skin>.png
GETAccess · Any API key

Check license

Validates an API key and returns account, plan, and expiry details.

GET/license?key=<api-key>

Use this before enabling paid features in your launcher or integration.

Parameters

keyRequired

Your TheAltening API key from the Account page.

Sample request
https://api.thealtening.com/v2/license?key=<api-key>
Response
{
  "username": "OnlyQubes",
  "hasLicense": true,
  "licenseType": "premium",
  "expires": "2020-08-05T00:00:00"
}
GETAccess · Paid plan required

Inspect a token

Checks whether a specific alt token is valid and returns token metadata.

GET/info?key=<api-key>&token=<alt-token>

Use this to validate a token or deciding whether to request a fresh one.

Parameters

keyRequired

Your TheAltening API key from the Account page.

tokenRequired

The alt token you want to inspect.

Sample request
https://api.thealtening.com/v2/info?key=<api-key>&token=<alt-token>
Response
{
  "expires": "2020-08-05T00:00:00",
  "skin": "555...",
  "username": "Examp**"
}
GETAccess · Premium and elite only

Favorite a token

Toggles favorite status for a token that belongs to your account.

GET/favorite?key=<api-key>&token=<alt-token>

The token must belong to the authenticated account and must not be expired. Send the same request again as a toggle to undo the favorite.

Parameters

keyRequired

Your TheAltening API key from the Account page.

tokenRequired

The account token to favorite or unfavorite.

Sample request
https://api.thealtening.com/v2/favorite?key=<api-key>&token=<alt-token>
Response
{ "success": true }
GETAccess · Premium and elite only

List favorites

Returns all tokens you have marked as favorites.

GET/favorites?key=<api-key>

Each item follows the same general shape as a generated token response, including token, username, skin, limit, and optional info fields.

Parameters

keyRequired

Your TheAltening API key from the Account page.

Sample request
https://api.thealtening.com/v2/favorites?key=<api-key>
Response
[
  {
    "token": "example@alt.com",
    "password": "anything",
    "username": "Examp**",
    "limit": false,
    "skin": "555cbe24c15f4793b70239935dde21f6",
    "info": {
      "hypixel.lvl": "10",
      "...": "..."
    }
  },
  {
    "token": "example2@alt.com",
    "password": "anything",
    "username": "Exampl**",
    "limit": false,
    "skin": "555cbe24c15f4793b70239935dde21f6",
    "info": {
      "mineplex.rank": "LEGEND",
      "...": "..."
    }
  }
]
GETAccess · Premium and elite only

Private a token

Toggles private status for a token that belongs to your account.

GET/private?key=<api-key>&token=<alt-token>

The token must belong to the authenticated account and must not be expired. Send the same request again to undo the private status.

Parameters

keyRequired

Your TheAltening API key from the Account page.

tokenRequired

The account token to mark private or unmark private.

Sample request
https://api.thealtening.com/v2/private?key=<api-key>&token=<alt-token>
Response
{ "success": true }
GETAccess · Premium and elite only

List privates

Returns all tokens you have marked as private. Premium users can private one token and Elite users can private five.

GET/privates?key=<api-key>

Each item follows the same general shape as a generated token response, including token, username, skin, limit, and optional info fields.

Parameters

keyRequired

Your TheAltening API key from the Account page.

Sample request
https://api.thealtening.com/v2/privates?key=<api-key>
Response
[
  {
    "token": "example@alt.com",
    "password": "anything",
    "username": "Examp**",
    "limit": false,
    "skin": "555...",
    "info": {
      "hypixel.lvl": "10",
      "...": "..."
    }
  },
  {
    "token": "example2@alt.com",
    "password": "anything",
    "username": "Exampl**",
    "limit": false,
    "skin": "666...",
    "info": {
      "mineplex.rank": "LEGEND",
      "...": "..."
    }
  }
]

Rate limits

Daily generation limits are plan-based

/generate is capped

The generate endpoint has a daily usage limit based on your plan. This is the "Botting / API Daily Limit" from our pricing page.

Limit loop behavior

When the daily cap is reached, responses loop from that day’s history so you can keep receiving tokens.

Check limit field

The limit Boolean tells you whether the per-day cap has been reached.

Rate Limit

Please make sure to not exceed our rate limit of 1 request per 0.5 seconds (120 requests per minute)

Error codes

Handle these statuses in your integration

401

Unauthorized

API key is missing or invalid.

403

Forbidden

Your plan cannot access the requested endpoint, such as a free user calling /generate or a non-Premium user calling private endpoints.

404

Not Found

Endpoint does not exist. Check the path and spelling.

500

Internal Server Error

Unexpected server error. Try again later.

Plan access

API access is included on paid plans.

Upgrade when you’re ready to connect your own launcher, bot, or manager.