---
title: "Get ledger transactions"
method: GET
path: "/programs/{id}/transactions/{period}"
tags: ["Sales"]
---

# Get ledger transactions

`GET /programs/{id}/transactions/{period}`

## Path parameters

- `id` string, required — An object id with prefix
- `period` string, required — period of data to be retrieved

## Query parameters

- `currency` string — currency of the transaction
- `ledger` 'payout' | 'payin' | 'reserve' — filter by type of ledger: payout is the ledger that tracks funds from sivo to the seller. payin is the ledger that tracks funds from the seller to sivo. reserve is the ledger that tracks deposit used for daily and minimum fees

## Response `200`

Successful operation

- object — List of items
  - `data` object[], required
    - `date` string, date, required — date of the transaction
    - `settled_at` string, date-time — date and time when the transaction was settled
    - `created_at` string, date-time, required — date and time when the transaction was created
    - `id` string, required — unique identifier of the ledger entry
    - `currency` string, required — currency of the transaction
    - `ledger` 'payout' | 'payin' | 'reserve', required — type of ledger: payout is the ledger that tracks funds from sivo to the seller. payin is the ledger that tracks funds from the seller to sivo.
    - `amount` integer, required — amount of the ledger entry
    - `amount_usd` integer, required — amount in USD, at the current fx rate
    - `type` 'pledge' | 'due' | 'transfer' | 'fee' | 'adjustment' | 'reversal', required — type of activity that triggered this transaction
    - `status` 'pending' | 'settled' | 'canceled', required — status of the ledger entry
    - `description` string, required — description of the transaction
    - `transaction_id` string, required — unique identifier of the ledger transaction
    - `account_id` string, required — unique identifier of the ledger account
    - `seller_id` string, required — unique identifier of the seller
    - `program_id` string, required — unique identifier of the program
    - `terms_id` string, required — unique identifier of the terms
    - `invoice_id` string — unique identifier of the invoice
    - `fiscal_invoice_id` string — unique identifier of the fiscal invoice
    - `buyer` string — name of the buyer
    - `balance` integer, required — balance of the ledger entry
    - `balance_usd` integer, required — balance in USD, at the current fx rate

---

[API](https://skmtc.net/sivo/apis/sivo-advance-api.md) · [All operations](https://skmtc.net/sivo/apis/sivo-advance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sivo/sivo-advance-api/versions/bfbcd2bfed61/schema)