---
title: "Get transactions"
method: GET
path: "/v1/transactions"
tags: ["Money"]
---

# Get transactions

`GET /v1/transactions`

Lists transaction history. Provide either `starting_after_cursor` or `ending_before_cursor` (not both) for cursor-based pagination.

## Query parameters

- `limit` integer
- `after_time` integer
- `before_time` integer
- `starting_after_cursor` string — string with format 'txc_base62_encoded_id' used for paginating a query to GET /v1/transactions
- `ending_before_cursor` string — string with format 'txc_base62_encoded_id' used for paginating a query to GET /v1/transactions
- `sort` 'transaction_time' | '-transaction_time' | 'amount' | '-amount' — Sort field. Prefix with `-` for descending order. Default: `-transaction_time`. Valid sort fields are:
- `transaction_type` 'stripe_card_payment' | 'manual_payment' | 'credit_grant' | 'refund' | 'buy_order' | 'sell_order'

## Response `200`

Successfully retrieved transactions

- MarketApiListTransactionsResponse
  - `object` 'list', required
  - `has_more` boolean, required
  - `data` MarketApiTransactionResponse[], required
    - `object` 'transaction', required
    - `cursor` string, required — string with format 'txc_base62_encoded_id' used for paginating a query to GET /v1/transactions
    - `transaction_time` integer, required — Time the transaction took place as UNIX timestamp in seconds.
    - `amount_cents` integer, required — Transaction amount in cents (e.g., 50000 = $500.00)
    - `balance` integer, required — Balance immediately after this transaction took place, in cents (e.g., 50000 = $500.00).
    - `details` union, required
      - object — Credit card payment made through stripe.
        - `object` 'transaction_details', required
        - `card_last4` string, required
        - `card_brand` string, required
        - `card_funding` string, required
        - `receipt_url` string, required
        - `type` 'stripe_card_payment', required
      - object — Payment settled outside the application with the sfcompute team.
        - `object` 'transaction_details', required
        - `description` string, required
        - `type` 'manual_payment', required
      - object — Credits granted by the sfcompute team.
        - `object` 'transaction_details', required
        - `memo` string, required
        - `type` 'credit_grant', required
      - object — Refund
        - `object` 'transaction_details', required
        - `type` 'refund', required
      - object — Purchase of compute via a buy order
        - `object` 'transaction_details', required
        - `order_id` string, required
        - `order` object, nullable
          - `object` 'order', required
          - `id` string, required
          - `side` 'buy' | 'sell', required
          - `status` 'open' | 'filled' | 'cancelled' | 'rejected', required
          - `instance_type` string, required
          - `quantity` integer, required
          - `start_at` string, date-time, required — An ISO 8601 datetime string
          - `end_at` string, date-time, required — An ISO 8601 datetime string
          - `price` integer, required — Price in cents
          - `flags` MarketApiOrderFlags, required — Configure more fine grained order behavior.
            - `ioc` boolean — If true, the order will be automatically cancelled if it doesn't immediately fill when being placed.
            - `post_only` boolean — If true, places the order straight into the book without trying to match against existing orders.
            - `market` boolean — If true, ignores the set limit price and matches any price that is available.
            - `prorate` boolean — If the order start time should be automatically changed to "now" once start time < "now", proportionally changing it's limit price to reflect it's shorter duration.
          - `executed` boolean, required
          - `executed_at` string, date-time — An ISO 8601 datetime string
          - `execution_price` integer, nullable
          - `cancelled` boolean, required
          - `cancelled_at` string, date-time — An ISO 8601 datetime string
          - `colocate_with` MarketApiContractId[]
          - `created_at` string, date-time, required — An ISO 8601 datetime string
          - `rejected` boolean, required
          - `rejected_reason` string, nullable
          - `cluster` string
          - `duration` integer, required — Unix timestamp.
        - `type` 'buy_order', required
      - object — Sale of compute via a sell order
        - `object` 'transaction_details', required
        - `order_id` string, required
        - `order` object, nullable
          - `object` 'order', required
          - `id` string, required
          - `side` 'buy' | 'sell', required
          - `status` 'open' | 'filled' | 'cancelled' | 'rejected', required
          - `instance_type` string, required
          - `quantity` integer, required
          - `start_at` string, date-time, required — An ISO 8601 datetime string
          - `end_at` string, date-time, required — An ISO 8601 datetime string
          - `price` integer, required — Price in cents
          - `flags` MarketApiOrderFlags, required — Configure more fine grained order behavior.
            - `ioc` boolean — If true, the order will be automatically cancelled if it doesn't immediately fill when being placed.
            - `post_only` boolean — If true, places the order straight into the book without trying to match against existing orders.
            - `market` boolean — If true, ignores the set limit price and matches any price that is available.
            - `prorate` boolean — If the order start time should be automatically changed to "now" once start time < "now", proportionally changing it's limit price to reflect it's shorter duration.
          - `executed` boolean, required
          - `executed_at` string, date-time — An ISO 8601 datetime string
          - `execution_price` integer, nullable
          - `cancelled` boolean, required
          - `cancelled_at` string, date-time — An ISO 8601 datetime string
          - `colocate_with` MarketApiContractId[]
          - `created_at` string, date-time, required — An ISO 8601 datetime string
          - `rejected` boolean, required
          - `rejected_reason` string, nullable
          - `cluster` string
          - `duration` integer, required — Unix timestamp.
        - `type` 'sell_order', required

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized - missing or invalid authentication token
- `500` — Internal server error

---

[API](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation.md) · [All operations](https://skmtc.net/sfcompute/apis/san-francisco-compute-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sfcompute/san-francisco-compute-documentation/revisions/93dd7661e9bb/schema)