---
title: "List transactions by reference"
method: GET
path: "/v1/customer-credits/transactions"
tags: ["Customer Credits - Transactions"]
---

# List transactions by reference

`GET /v1/customer-credits/transactions`

## Request

- Base URL: `https://api.creem.io`
- URL: `https://api.creem.io/v1/customer-credits/transactions`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/creem/apis/creem-api/docs/v1/customer-credits/transactions/get.ts> (a function with typed inputs; its response is checked against the schema)

List all transactions matching a reference string.

## Query parameters

- `reference` string, required

## Response `200`

List of transactions

- TransactionListResponseDto
  - `object` string, required: Object type
  - `data` TransactionResponseDto[], required: Array of transactions
    - `id` string, required: Transaction ID
    - `store_id` string, required: Store ID
    - `reference` string, required: Reference string
    - `idempotency_key` string, required: Idempotency key
    - `reversal_of` string, nullable: ID of the transaction this reverses, if applicable
    - `entries` EntryResponseDto[], required: Transaction entries
      - `id` string, required: Entry ID
      - `transaction_id` string, required: Transaction ID
      - `account_id` string, required: Account ID
      - `side` 'debit' | 'credit', required: Debit or credit side
      - `amount` string, required: Amount as string for bigint safety
      - `created_at` string, required: Creation timestamp
    - `created_at` string, required: Creation timestamp
  - `has_more` boolean, required: Whether more items exist beyond this page

## Other responses

- `400`: Bad Request - Invalid input parameters
- `401`: Unauthorized - Invalid or missing API key
- `404`: Not Found - Resource does not exist

## Changes

- **2026-09-15** `4b5d3db71ff5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/creem/apis/creem-api/changes/v1/customer-credits/transactions/get.md)

---

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