RedditAPIRedditAPIs
Account

List Account Top-up and 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.

GET/account/paymentsFree

List your account's payment history, sorted by most recent first. Free — does not consume credits.

Rate-limited to 30 requests/minute per API key.

Success Response

{
  "payments": [
    {
      "amount": 25,
      "credits_added": 25,
      "status": "completed",
      "created_at": "2026-04-12T08:42:11.000Z"
    },
    {
      "amount": 10,
      "credits_added": 10,
      "status": "completed",
      "created_at": "2026-03-18T19:07:33.000Z"
    }
  ]
}

If no payments have been made yet:

{ "payments": [] }

Field Reference

FieldDescription
payments[].amountAmount paid, in USD.
payments[].credits_addedCredits added to the account from this payment.
payments[].statusPayment status: completed, pending, or failed.
payments[].created_atWhen the payment was processed.

Example

curl -H "Authorization: Bearer $TOKEN" \
  "https://api.redditapis.com/account/payments"
const response = await fetch("https://api.redditapis.com/account/payments", {
  headers: { Authorization: "Bearer TOKEN" },
});
const data = await response.json();
import requests

response = requests.get(
    "https://api.redditapis.com/account/payments",
    headers={"Authorization": "Bearer TOKEN"},
)
data = response.json()

Errors

StatusMeaning
401Missing Bearer token
403Invalid Bearer token
429Rate limit exceeded (>30 req/min)
500Unexpected server error

On this page