---
title: "Get all scheduled transactions"
method: GET
path: "/plans/{plan_id}/scheduled_transactions"
tags: ["Scheduled Transactions"]
---

# Get all scheduled transactions

`GET /plans/{plan_id}/scheduled_transactions`

Returns all scheduled transactions

## Path parameters

- `plan_id` string, required

## Query parameters

- `last_knowledge_of_server` integer

## Response `200`

The list of requested scheduled transactions

- ScheduledTransactionsResponse
  - `data` object, required
    - `scheduled_transactions` 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
    - `server_knowledge` integer, required — The knowledge of the server

## Other responses

- `404` — No scheduled transactions were found

---

[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-service-production.skmtc.workers.dev/v1/apis/ynab/ynab-api-endpoints/revisions/da7a78345b34/schema)