---
title: "List your credit transactions"
method: GET
path: "/credits/transactions"
tags: ["meta"]
---

# List your credit transactions

`GET /credits/transactions`

## Request

- Base URL: `https://www.socialcrawl.dev/v1`
- URL: `https://www.socialcrawl.dev/v1/credits/transactions`
- Auth: API key in header `x-api-key`

Returns your credit ledger (deductions negative, refunds positive) as dispute-grade receipts, newest first. Cursor-paginated and filterable by request_id. Metadata call - costs 0 credits and never hits upstream platforms.

## Query parameters

- `limit` integer
- `cursor` string
- `request_id` string

## Response `200`

Successful response

- object
  - `success` boolean, required
  - `platform` string, required
  - `endpoint` string, required
  - `data` object, required
    - `items` object[], required
      - `id` string, required
      - `type` 'purchase' | 'deduction' | 'refund' | 'bonus', required
      - `amount` integer, required
      - `balance_after` integer, required
      - `description` string, nullable
      - `endpoint` string, nullable
      - `platform` string, nullable
      - `credit_tier` 'standard' | 'advanced' | 'premium' | 'null', nullable
      - `request_id` string, nullable
      - `created_at` string, date-time, required
    - `next_cursor` string, nullable, required
  - `credits_used` integer, required
  - `credits_remaining` integer
  - `request_id` string, required
  - `cached` boolean, required

## Other responses

- `401`: Unauthorized - missing or invalid API key
- `405`: Method not allowed - wrong HTTP verb for this endpoint
- `429`: Rate or concurrency limit exceeded. `RATE_LIMITED`: more than 600 requests in a 1-minute sliding window on this API key (headers `X-RateLimit-Limit`/`Remaining`/`Reset`; `Retry-After` is seconds until the window resets). `CONCURRENCY_LIMIT`: more than 50 simultaneous in-flight requests (headers `X-Concurrency-Limit`/`Remaining`; short static `Retry-After`). Both are unbilled. Honor `Retry-After`, then back off with jitter. See /docs/rate-limits.
- `500`: Internal server error - an immediate refund is attempted; credits_used reports the committed net charge and exact compensation is queued if that refund cannot commit

---

[API](https://skmtc.dev/socialcrawl/apis/socialcrawl-api.md) · [All operations](https://skmtc.dev/socialcrawl/apis/socialcrawl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/socialcrawl/apis/socialcrawl-api/revisions/a0ad2511004a?raw)