---
title: "List wallet transactions"
method: GET
path: "/wallet/transactions"
tags: ["Wallet"]
---

# List wallet transactions

`GET /wallet/transactions`

Retrieve a paginated list of wallet transactions for the organization.

    Optional query filters:
    - `transaction_type` — filter by `ADD` or `CONSUME`
    - `created_after` — return only transactions on or after this ISO-8601 datetime

    Transactions are returned newest-first. Stripe references and internal
    balance snapshots are intentionally omitted.

    Authentication:
    - API key with READ or READ_WRITE permission

## Query parameters

- `transaction_type` string, nullable — Filter by transaction direction: 'ADD' or 'CONSUME'.
- `created_after` string, date-time, nullable — Return only transactions created on or after this datetime (ISO-8601, e.g. '2025-01-01T00:00:00'). Invalid values are rejected with a 400 error.
- `limit` integer — Maximum number of transactions to return.
- `offset` integer — Number of transactions to skip.

## Response `200`

Successfully retrieved wallet transactions

- object
  - `ok` boolean
  - `data` object[]
  - `meta` object
    - `limit` integer
    - `offset` integer
    - `total_items` integer

## Other responses

- `401` — Invalid or missing API key
- `403` — Insufficient permissions
- `404` — Resource not found

---

[API](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1.md) · [All operations](https://skmtc.net/yourang/apis/yourang-ai-external-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yourang/yourang-ai-external-api-v1/revisions/49680ee64400/schema)