---
title: "List Transactions"
method: GET
path: "/api/v1/billing/transactions"
tags: ["Billing"]
---

# List Transactions

`GET /api/v1/billing/transactions`

## Request

- The document declares no server URL.
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.mor.org/oauth2/authorize`
    - Token URL: `https://auth.mor.org/oauth2/token` scopes: `aws.cognito.signin.user.admin`, `openid`, `email`, `profile`
  - HTTP bearer

Get paginated list of credit transactions (ledger entries).

Authenticate with either a Cognito JWT or an ``sk-…`` API key.

Parameters:
- limit: Maximum number of items to return (1-∞)
- offset: Number of items to skip
- type: Filter by entry type (purchase, usage_charge, refund, etc.)
- from: Filter entries created after this datetime
- to: Filter entries created before this datetime

Returns newest entries first.

## Query parameters

- `limit` integer
- `offset` integer
- `entry_type` 'purchase' | 'staking_refresh' | 'usage_hold' | 'usage_charge' | 'refund' | 'adjustment': Ledger entry type.
- `from` string, date-time
- `to` string, date-time

## Response `200`

Successful Response

- LedgerListResponse: Paginated response for ledger entries.
  - `items` LedgerEntryResponse[], required
    - `id` string, uuid, required
    - `user_id` integer, required
    - `currency` string, required
    - `status` 'pending' | 'posted' | 'voided', required: Ledger entry status.
    - `entry_type` 'purchase' | 'staking_refresh' | 'usage_hold' | 'usage_charge' | 'refund' | 'adjustment', required: Ledger entry type.
    - `amount_paid` string, required
    - `amount_staking` string, required
    - `amount_total` string, required
    - `idempotency_key` string
    - `related_entry_id` string, uuid
    - `payment_source` string
    - `external_transaction_id` string
    - `payment_metadata` object
    - `request_id` string
    - `api_key_id` integer
    - `model_name` string
    - `model_id` string
    - `endpoint` string
    - `tokens_input` integer
    - `tokens_output` integer
    - `tokens_total` integer
    - `input_price_per_million` string
    - `output_price_per_million` string
    - `failure_code` string
    - `failure_reason` string
    - `description` string
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required
  - `has_more` boolean, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-05-22** `6059f99c1875`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/changes/api/v1/billing/transactions/get.md)

---

[API](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway.md) - [All operations](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/revisions/6059f99c1875?raw)