---
title: "Create Ledger Transaction Reversal"
method: POST
path: "/ledger_transactions/{id}/reversal"
---

# Create Ledger Transaction Reversal

`POST /ledger_transactions/{id}/reversal`

## Path parameters

- `id` string, required

## Request body

- object
  - `description` string — An optional free-form description for the reversal ledger transaction. Maximum of 1000 characters allowed.
  - `status` string — Status of the reversal ledger transaction. It defaults to `posted` if not provided.
  - `metadata` string, json — Metadata to be added to the reversal ledger transaction. Must be a JSON object.
  - `effective_at` string, date-time — The timestamp (ISO8601 format) at which the reversal ledger transaction happened for reporting purposes. It defaults to the `effective_at` of the original ledger transaction if not provided.
  - `ledgerable_type` string — Specify this if you'd like to link the reversal ledger transaction to a Payment object like Return or Reversal.
  - `ledgerable_id` string — Specify this if you'd like to link the reversal ledger transaction to a Payment object like Return or Reversal.

## Response `201`

201

- object
  - `id` string
  - `object` string
  - `live_mode` boolean
  - `external_id` string
  - `ledgerable_type` unknown
  - `ledgerable_id` unknown
  - `ledger_id` string
  - `description` unknown
  - `status` string
  - `reverses_ledger_transaction_id` string
  - `ledger_entries` object[]
    - `id` string
    - `object` string
    - `live_mode` boolean
    - `amount` integer
    - `direction` string
    - `status` string
    - `ledger_account_id` string
    - `ledger_account_currency` string
    - `ledger_account_currency_exponent` integer
    - `ledger_account_lock_version` integer
    - `ledger_transaction_id` string
    - `resulting_ledger_account_balances` object
      - `pending_balance` object
        - `credits` integer
        - `debits` integer
        - `amount` integer
        - `currency` string
        - `currency_exponent` integer
      - `posted_balance` object
        - `credits` integer
        - `debits` integer
        - `amount` integer
        - `currency` string
        - `currency_exponent` integer
      - `available_balance` object
        - `credits` integer
        - `debits` integer
        - `amount` integer
        - `currency` string
        - `currency_exponent` integer
    - `discarded_at` unknown
    - `created_at` string
    - `updated_at` string
  - `posted_at` string
  - `effective_at` string
  - `effective_date` string
  - `metadata` object
  - `created_at` string
  - `updated_at` string

## Other responses

- `422` — 422

---

[API](https://skmtc.net/modern-treasury/apis/modern-treasury-api.md) · [All operations](https://skmtc.net/modern-treasury/apis/modern-treasury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modern-treasury/modern-treasury-api/revisions/ed0431a2dcd0/schema)