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

# GET /v0/transactions

`GET /v0/transactions`

## Query parameters

- `starting_after` string, date-time — Return transactions after this timestamp (exclusive)
- `ending_before` string, date-time — Return transactions before this timestamp (exclusive)
- `limit` string — Maximum number of transactions to return (default: 50, max: 500)
- `transaction_type` union — Filter transactions by one or more transaction types. No filter shows all transaction categories.
  - 'buy' | 'sell' | 'transfer' | 'error' | 'instant_deposit' | 'deposit_ach' | 'withdrawal_bank' | 'refund' | 'admin_ledger_transfer' | 'fulfillment_escrow_release' | 'promotional_credit' | 'delivery_fees_collected'
  - string[]
- `account_kind` union — Filter transactions by one or more account kinds. Primary account most relevant for most users. No filter shows all account kinds.
  - 'primary' | 'capital' | 'withdrawal_reserve' | 'fulfillment_escrow' | 'delivery_fee_escrow' — The kind of account involved in the transaction. Each user has one account of each account kind. The account "primary" is the main one used for buy/sell on the platform.
  - SanFranciscoComputeDocumentationAccountKind[]

## Response `200`

List of transactions for the account

- SanFranciscoComputeDocumentationAccountTransactions — List of transactions for an account
  - `object` 'transactions', required — The type of the response object
  - `transactions` SanFranciscoComputeDocumentationTransaction[], required — Transactions for all accounts (see account kind) associated with this user.
    - `id` string, required — Unique identifier for the transaction
    - `timestamp` string, date-time, required — When the money movement occurred within SFCs system
    - `direction` 'incoming' | 'outgoing', required — Whether the transaction is incoming to or outgoing from the account.
    - `status` 'accepted' | 'rejected', required — The current status of a transaction.
    - `amount` integer, required — Transaction amount in cents
    - `account_kind` 'primary' | 'capital' | 'withdrawal_reserve' | 'fulfillment_escrow' | 'delivery_fee_escrow', required — The kind of account involved in the transaction. Each user has one account of each account kind. The account "primary" is the main one used for buy/sell on the platform.
    - `balance_before` integer, required — Account balance before transaction in cents
    - `balance_after` integer, required — Account balance after transaction in cents
    - `metadata` union, required — Additional transaction-specific details
      - object — A buy order was filled
        - `type` 'buy', required
        - `instance_type_requirements` object, required — Requirements specified for the buy order
          - `accelerator_types` string[] — List of allowed accelerator types.
          - `interconnect_types` string[] — List of allowed interconnect types.
          - `regions` string[] — List of allowed regions.
          - `delivery_type` 'K8s' | 'VM', required — Delivery method.
        - `quantity` integer, required — Quantity requested in the buy order, in number of nodes (8 gpus)
        - `start_time` string, date-time, required — The buy orders requested start time of the compute
        - `end_time` string, date-time, required — The buy orders requested end time of compute
        - `order_id` string, required — An external ID with prefix and alphanumeric string with underscores
      - object — A sell order was filled.
        - `type` 'sell', required
        - `quantity` integer, required — Quantity that was requested to sell, In number of nodes (8 gpus)
        - `start_time` string, date-time, required — The orders requested start time of the compute to sell
        - `end_time` string, date-time, required — The orders requested end time of compute to sell
        - `order_id` string, required — The sell order that was executed.
      - object — Transfer from another account within SFC - within or outside your organization. If you don't recognize this, contact SFC.
        - `type` 'transfer', required
      - object — Something went wrong when collecting information about the transaction - SFC is automatically notified if this occurs, but if you need prompt answers contact SFC.
        - `type` 'error', required
        - `inner_type` string, required — Best effort type of the transaction without additional metadata, but may be 'unknown'
        - `message` unknown
      - object — A card deposit landed.
        - `type` 'instant_deposit', required
        - `completed_at` string, date-time, required — The time the bank involved marked marked this transaction as completed.
        - `card_last4` string, required — The last 4 digits of the card that was used to perform the payment.
        - `card_brand` string, required — Brand of card used for payment.
        - `card_funding` string, required — The funding type of the card.
        - `receipt_url` string, uri — URL for the receipt if available.
      - object — A bank deposit landed.
        - `type` 'deposit_ach', required
        - `date_initiated` string, date-time, required — The date the bank withdrawal was initiated.
        - `date_cancelled` string, date-time, nullable, required — The date the bank withdrawal was cancelled, if it was cancelled.
        - `date_settled` string, date-time, nullable, required — The date the bank withdrawal settled by the bank, if it was cancelled. This will in most cases be close to the time SFC processed the transaction.
        - `account_description` string, required — A short description of the account.
        - `bank_account_last4` string, required — The last 4 digits of the bank account number.
      - object — A bank withdrawal occurred.
        - `type` 'withdrawal_bank', required
        - `approved_at` string, date-time, required — The date this bank withdrawal was approved.
        - `account_description` string, required — A short description of the account.
        - `bank_account_last4` string, required — The last 4 digits of the bank account number.
      - object — A refund was accepted.
        - `type` 'refund', required
        - `start_time` string, date-time, required — Start time of experienced downtime.
        - `end_time` string, date-time, required — End time of experienced downtime.
        - `quantity` integer, required — In number of nodes (8 gpus) affected during this period.
        - `refund_cents_per_gpu_hour` number, required — The index rate per GPU, in cents, used to calculate the refund amount.
        - `report_id` string, required — Downtime report ID that resulted in this refund being issued.
        - `issue_date` string, date-time, required — The time at which SFC approved the refund.
      - object — An exchange of funds was performed by an administrator at SFC. If you don't recognize the reason for this, contact SFC.
        - `type` 'admin_ledger_transfer', required
      - object — Payout for compute sold over the prior month.
        - `type` 'fulfillment_escrow_release', required
      - object — A promotional credit from SFC.
        - `type` 'promotional_credit', required
      - object — only SFC accounts should ever collect these types of fees. If you are not part of the SFC organization, please let us know.
        - `type` 'delivery_fees_collected', required
  - `pagination` object, required — Pagination information
    - `has_more` boolean, required — Whether there are more transactions available
    - `count` integer, required — Number of transactions returned
    - `oldest_timestamp` string, date-time, nullable, required — Timestamp of the oldest transaction returned, useful for pagination
    - `newest_timestamp` string, date-time, nullable, required — Timestamp of the newest transaction returned, useful for pagination

---

[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)