Skip to content
GET/account/paymentsFree

Account: Payments

Return the authenticated account's payment ledger: credit purchases and the running balance. This call is free and does not consume credits.

  • This endpoint is free and never consumes credits.

Request

curl "https://api.twitterapis.com/account/payments" \
  -H "Authorization: Bearer $TWITTERAPIS_KEY"

Parameters

ParameterTypeRequiredDescription
cursorstringoptional

Pagination cursor for long ledgers.

Response

FieldTypeDescription
paymentsarray<Payment>

Ledger entries (amount, type, created_at) for this page.

has_next_pageboolean

True when more results are available; pass next_cursor to fetch them.

next_cursorstring

Opaque cursor token for the next page. Empty string on the final page.

statusstring

Request status, "success" on a normal response.

Example response

{
  "payments": [
    {
      "id": "pay_8841",
      "amount": "10.00",
      "type": "credit_purchase",
      "created_at": "2026-02-18T12:04:00Z"
    },
    {
      "id": "signup_credit",
      "amount": "0.50",
      "type": "free_signup_credit",
      "created_at": "2026-02-01T09:00:00Z"
    }
  ],
  "has_next_page": false,
  "next_cursor": "",
  "status": "success"
}

Pricing for this endpoint

account/payments is a free metadata endpoint and never consumes credits. Every billable read endpoint is $0.0008 per call (~20 tweets), or $0.04 per 1,000 tweets.

Related endpoints