> ## Documentation Index > Fetch the complete documentation index at: https://docs.socialquery.dev/llms.txt > Use this file to discover all available pages before exploring further. # 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. 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. ## OpenAPI ````yaml GET /credits/transactions openapi: 3.1.0 info: title: SocialQuery API version: '2026-10-09' description: >- Documented requests for public-source records. Inspect accepted inputs and credit amounts, then verify the selected operation before integrating preview coverage. servers: - url: https://socialquery.dev/v1 security: - apiKey: [] paths: /credits/transactions: get: tags: - meta summary: List your credit receipts description: >- 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. operationId: meta_credits_transactions parameters: - name: limit in: query required: false description: >- Positive integer, default 50. Values greater than 100 are capped at 100. schema: type: integer minimum: 1 maximum: 100 default: 50 - name: cursor in: query required: false description: >- Opaque next_cursor. Malformed cursors or cursors from a different request_id filter restart at the newest entry. schema: type: string - name: request_id in: query required: false description: Exact request ID, 1–200 printable characters. schema: type: string minLength: 1 maxLength: 200 responses: '200': description: 'Private account data. Cache-Control: private, no-store.' content: application/json: schema: type: object properties: success: type: boolean const: true platform: type: string const: meta endpoint: type: string const: /v1/credits/transactions data: type: object properties: items: type: array items: type: object properties: id: type: string type: type: string enum: - purchase - deduction - refund - bonus - adjustment amount: type: integer balance_after: type: integer description: type: - string - 'null' endpoint: type: - string - 'null' platform: type: - string - 'null' credit_tier: type: 'null' description: >- No historical tier is recorded; this field remains null. request_id: type: - string - 'null' created_at: type: string format: date-time required: - id - type - amount - balance_after - description - endpoint - platform - credit_tier - request_id - created_at next_cursor: type: - string - 'null' required: - items - next_cursor credits_used: type: integer const: 0 credits_remaining: type: integer request_id: type: string cached: type: boolean const: false required: - success - platform - endpoint - data - credits_used - credits_remaining - request_id - cached '401': description: Missing, invalid, expired or revoked key. content: application/json: schema: $ref: 0b3c5f4c-b083-4ca1-a9ed-7b6dbb011daa '403': description: The key does not grant this endpoint scope. content: application/json: schema: $ref: 0b3c5f4c-b083-4ca1-a9ed-7b6dbb011daa '405': description: Use GET. content: application/json: schema: $ref: 0b3c5f4c-b083-4ca1-a9ed-7b6dbb011daa '422': description: Invalid parameters. content: application/json: schema: $ref: 0b3c5f4c-b083-4ca1-a9ed-7b6dbb011daa '429': description: API key rate limit reached. content: application/json: schema: $ref: 0b3c5f4c-b083-4ca1-a9ed-7b6dbb011daa '503': description: Account storage temporarily unavailable. No credit charge. content: application/json: schema: $ref: 0b3c5f4c-b083-4ca1-a9ed-7b6dbb011daa security: - ApiKeyAuth: [] components: securitySchemes: apiKey: type: apiKey in: header name: x-api-key ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.