---
title: "Get credit transaction history"
method: GET
path: "/v1/profile/credits/transactions"
tags: ["Profile"]
---

# Get credit transaction history

`GET /v1/profile/credits/transactions`

## Query parameters

- `limit` integer
- `cursor` string
- `direction` 'after' | 'before'

## Response `200`

Credit transactions retrieved successfully

- CreditTransactionsApiResponseDto
  - `success` boolean, required — Indicates if the request was successful
  - `message` string, required — Human readable message
  - `data` object[], required — Array of data items
    - `id` string, uuid, required — Unique identifier of the transaction
    - `userId` string, uuid, required — User ID associated with the transaction
    - `amount` integer, required — Transaction amount (positive for credit, negative for debit)
    - `transactionType` 'debit' | 'credit', required — Transaction type
    - `balanceType` 'allocated' | 'purchased', required — Which balance was affected (allocated/purchased)
    - `source` 'monthly_allocation' | 'purchase' | 'image_generation' | 'floorplan_recognition' | 'floorplan_generation' | 'floorplan_optimization' | 'scene_render' | 'manual_adjustment' | 'promotional' | 'proration', required — Credit source
    - `referenceId` string, nullable, required — Reference ID (order, subscription, etc.)
    - `description` string, nullable, required — Transaction description
    - `createdAt` unknown, required
  - `meta` object, required — Pagination metadata
    - `hasNext` boolean, required — Whether there are more items after current set
    - `hasPrevious` boolean, required — Whether there are items before current set
    - `nextCursor` string, nullable, required — Cursor for next page
    - `prevCursor` string, nullable, required — Cursor for previous page
  - `timestamp` string, date-time, required — Timestamp of the response

---

[API](https://skmtc.dev/maket/apis/virtual-architect-api.md) · [All operations](https://skmtc.dev/maket/apis/virtual-architect-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/maket/virtual-architect-api/revisions/7635e6f94477/schema)
