List your credit receipts

curl --request GET \
  --url https://socialquery.dev/v1/credits/transactions

{
  "success": true,
  "platform": "meta",
  "endpoint": "/v1/credits/transactions",
  "data": {
    "items": [
      {
        "id": "<string>",
        "type": "purchase",
        "amount": 123,
        "balance_after": 123,
        "description": "<string>",
        "endpoint": "<string>",
        "platform": "<string>",
        "credit_tier": null,
        "request_id": "<string>",
        "created_at": "2023-11-07T05:31:56Z"
      }
    ],
    "next_cursor": "<string>"
  },
  "credits_used": 0,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": false
}

Account credits

Credit transactions

Free authenticated ledger read, newest first by creation time and ID. Only the authenticated account is visible. Deductions include initial reservations; refunds release unused or failed-request credits. Sum entries for a request_id to find its net charge. A stored refund can be updated by a later settlement, so pages are not an immutable historical snapshot. Refund balance_after reflects the latest settlement; ordering remains its original creation time. Administrative adjustments retain type adjustment. Pending log joins and historical credit tiers can be null. No provider requests or charges. Responses are private and never cached.

GET

credits

transactions

List your credit receipts

curl --request GET \
  --url https://socialquery.dev/v1/credits/transactions

{
  "success": true,
  "platform": "meta",
  "endpoint": "/v1/credits/transactions",
  "data": {
    "items": [
      {
        "id": "<string>",
        "type": "purchase",
        "amount": 123,
        "balance_after": 123,
        "description": "<string>",
        "endpoint": "<string>",
        "platform": "<string>",
        "credit_tier": null,
        "request_id": "<string>",
        "created_at": "2023-11-07T05:31:56Z"
      }
    ],
    "next_cursor": "<string>"
  },
  "credits_used": 0,
  "credits_remaining": 123,
  "request_id": "<string>",
  "cached": false
}

Requires your SocialQuery API key. Costs 0 credits and makes no upstream requests. Receipts are private to your account. Use request_id to reconcile a single request, or pass the returned next_cursor for another page. A debit reserves credits; its refund releases the unused amount. Sum the signed amounts for the settled charge. Refunds can receive later settlement updates, and unrecorded credit tiers stay null. Hosted and stdio MCP expose get_credit_transactions. The Python skill supports transactions --limit 20, --cursor, and --request-id. Neither client automatically paginates.

Query Parameters

limit

integer

default:50

Positive integer, default 50. Values greater than 100 are capped at 100.

Required range: 1 <= x <= 100

cursor

string

Opaque next_cursor. Malformed cursors or cursors from a different request_id filter restart at the newest entry.

request_id

string

Exact request ID, 1–200 printable characters.

Required string length: 1 - 200

Response

Private account data. Cache-Control: private, no-store.

success

boolean

required

platform

string

required

Allowed value: "meta"

endpoint

string

required

Allowed value: "/v1/credits/transactions"

data

object

required

Show child attributes

credits_used

integer

required

credits_remaining

integer

required

request_id

string

required

cached

boolean

required