---
title: "Delete a scheduled transaction"
method: DELETE
path: "/plans/{plan_id}/scheduled_transactions/{scheduled_transaction_id}"
tags: ["Scheduled Transactions"]
---

# Delete a scheduled transaction

`DELETE /plans/{plan_id}/scheduled_transactions/{scheduled_transaction_id}`

## Request

- Base URL: `https://api.ynab.com/v1`
- URL: `https://api.ynab.com/v1/plans/{plan_id}/scheduled_transactions/{scheduled_transaction_id}`
- Auth: HTTP bearer

Deletes a scheduled transaction

## Path parameters

- `plan_id` string, required
- `scheduled_transaction_id` string, required

## Response `200`

The scheduled transaction was successfully deleted

- ScheduledTransactionResponse
  - `data` object, required
    - `scheduled_transaction` ScheduledTransactionDetail, required
      - `id` string, uuid, required
      - `date_first` string, date, required: The first date for which the Scheduled Transaction was scheduled.
      - `date_next` string, date, required: The next date for which the Scheduled Transaction is scheduled.
      - `frequency` 'never' | 'daily' | 'weekly' | 'everyOtherWeek' | 'twiceAMonth' | 'every4Weeks' | 'monthly' | 'everyOtherMonth' | 'every3Months' | 'every4Months' | 'twiceAYear' | 'yearly' | 'everyOtherYear', required
      - `amount` integer, required: The scheduled transaction amount in milliunits format
      - `memo` string, nullable
      - `flag_color` 'red' | 'orange' | 'yellow' | 'green' | 'blue' | 'purple' | '' | 'null', nullable: The transaction flag
      - `flag_name` string, nullable: The customized name of a transaction flag
      - `account_id` string, uuid, required
      - `payee_id` string, uuid, nullable
      - `category_id` string, uuid, nullable
      - `transfer_account_id` string, uuid, nullable: If a transfer, the account_id which the scheduled transaction transfers to
      - `deleted` boolean, required: Whether or not the scheduled transaction has been deleted. Deleted scheduled transactions will only be included in delta requests.
      - `amount_formatted` string: The scheduled transaction amount formatted in the plan's currency format
      - `amount_currency` number, double: The scheduled transaction amount as a decimal currency amount
      - `account_name` string, required
      - `payee_name` string, nullable
      - `category_name` string, nullable: The name of the category. If a split scheduled transaction, this will be 'Split'.
      - `subtransactions` ScheduledSubTransaction[], required: If a split scheduled transaction, the subtransactions.
        - `id` string, uuid, required
        - `scheduled_transaction_id` string, uuid, required
        - `amount` integer, required: The scheduled subtransaction amount in milliunits format
        - `memo` string, nullable
        - `payee_id` string, uuid, nullable
        - `payee_name` string, nullable
        - `category_id` string, uuid, nullable
        - `category_name` string, nullable
        - `transfer_account_id` string, uuid, nullable: If a transfer, the account_id which the scheduled subtransaction transfers to
        - `deleted` boolean, required: Whether or not the scheduled subtransaction has been deleted. Deleted scheduled subtransactions will only be included in delta requests.
        - `amount_formatted` string: The scheduled subtransaction amount formatted in the plan's currency format
        - `amount_currency` number, double: The scheduled subtransaction amount as a decimal currency amount

## Other responses

- `404`: The scheduled transaction was not found

## Changes

- **2026-05-03** `1e4aa027827c`: 13 breaking, 12 warning, 2 info
  - the `data/scheduled_transaction/allOf[#/components/schemas/ScheduledTransactionSummary]/` response's property type changed from `object` to no type for status `200`
  - the `data/scheduled_transaction/allOf[subschema #2]/subtransactions/items/` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/scheduled_transaction/allOf[#/components/schemas/ScheduledTransactionSummary]/account_id` from the response with the `200` status
  - removed the required property `data/scheduled_transaction/allOf[#/components/schemas/ScheduledTransactionSummary]/amount` from the response with the `200` status
  - …23 more
- **2026-04-01** `60411c83c141`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ynab/apis/ynab-api-endpoints/changes/plans/:plan_id/scheduled_transactions/:scheduled_transaction_id/delete.md)

---

[API](https://skmtc.dev/ynab/apis/ynab-api-endpoints.md) - [All operations](https://skmtc.dev/ynab/apis/ynab-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/ynab/apis/ynab-api-endpoints/revisions/de784d4bf470?raw)