Authentication

TierUp.AI uses API keys to authenticate every request. Keep your key secret and never commit it to source control.

API Keys

Every TierUp.AI API key starts with the prefix tup_ followed by 32 lowercase hexadecimal characters — 36 characters total. Keys are passed as a Bearer token in the Authorization header of every request.

text

tup_<32 hex characters>

Using your API key

Include the key in the Authorization header on every API call:

http

Authorization: Bearer tup_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4

Full example with curl:

bash

curl -X POST https://api.tierup.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "Hello"}], "tier": 1}'

Requests without a valid key — or with a malformed key — will receive a 401 Unauthorized response.

Sign-up methods

You can create a TierUp.AI account at api.tierup.ai/v1/auth/login using any of the following methods:

Email / password — Enter your email and choose a password. A verification email will be sent before your account is activated.
GitHub OAuth — Authorise TierUp.AI via GitHub. Your primary GitHub email is used as the account email.
Google OAuth — Sign in with your Google account. No separate password is needed.

All methods are free and require no credit card to get started.

Key lifecycle

Your API key is shown exactly once — immediately after account creation. TierUp.AI does not store a recoverable copy.

Copy it immediately. If you navigate away before saving, the key cannot be retrieved. You can generate a replacement key at any time from Settings.

To rotate a key, generate a new one from Settings — the old key stops working immediately (one active key per account). We recommend storing the key as an environment variable (e.g. TIERUP_API_KEY) and never hard-coding it in source files.

Endpoints

Profile & balance

GET/v1/auth/meReturns your profile and balance

Response fields:

Field	Type	Required	Description
id	string	—	Unique account identifier.
email	string	—	The email address associated with your account.
name	string	—	Display name on the account.
api_key_prefix	string	—	The first 12 characters of your API key (e.g. "tup_a1b2c3d4").
has_payment_method	boolean	—	Whether a valid payment method is on file.
balance_cents	integer	—	Prepaid credit balance in USD cents.

Example request:

bash

curl https://api.tierup.ai/v1/auth/me \
  -H "Authorization: Bearer YOUR_API_KEY"