Account
Get Account Info, Balance, and Usage Summary
Get your account info, remaining credit balance, total credits used, and request count. Free, no per-call cost — use it for dashboards and billing checks.
GET
/account/meFreeGet your account info, current balance, and usage summary. Free — does not consume credits.
Rate-limited to 30 requests/minute per API key.
Success Response
{
"email": "alex@acme.dev",
"name": "Alex Morgan",
"credits_remaining": 8.96,
"credits_used": 13.832,
"total_requests": 12251,
"created_at": "2026-02-06T10:14:22.318401+00:00"
}Field Reference
| Field | Description |
|---|---|
email | Email on the account. |
name | Display name. |
credits_remaining | Current balance in USD (e.g. 8.96 = $8.96 left). |
credits_used | Lifetime credits spent in USD. |
total_requests | Lifetime number of API calls made. |
created_at | When the account was created. |
Example
curl -H "Authorization: Bearer $TOKEN" \
"https://api.redditapis.com/account/me"const response = await fetch("https://api.redditapis.com/account/me", {
headers: { Authorization: "Bearer TOKEN" },
});
const data = await response.json();import requests
response = requests.get(
"https://api.redditapis.com/account/me",
headers={"Authorization": "Bearer TOKEN"},
)
data = response.json()Errors
| Status | Meaning |
|---|---|
401 | Missing Bearer token |
403 | Invalid Bearer token |
429 | Rate limit exceeded (>30 req/min) |
500 | Unexpected server error |
Upload Avatar / BannerNew
Upload a new avatar (profile picture) or banner to a Reddit account via URL, base64, or local path. PNG/JPEG auto-detected, no browser automation needed.
Payment History
List the top-ups and payments made to your account, sorted newest first. Free to call — useful for invoicing, accounting, and reconciling credit purchases.