---
title: "List Scheduled ACH Transfers"
method: GET
path: "/accounts/{account_id}/ach/scheduled"
tags: ["Transfers"]
---

# List Scheduled ACH Transfers

`GET /accounts/{account_id}/ach/scheduled`

## Request

- Base URL: `https://api.meow.com/v1`
- URL: `https://api.meow.com/v1/accounts/{account_id}/ach/scheduled`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/meow/apis/meow-api/docs/accounts/:account_id/ach/scheduled/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of scheduled ACH transfers for a specified account.

## Path parameters

- `account_id` string, required: The ID of the account.

## Query parameters

- `limit` integer: Maximum number of results to return.
- `offset` string, nullable: Opaque offset identifier for pagination. Use the nextOffset from a previous response.

## Headers

- `x-entity-id` string, uuid

## Response `200`

Successful Response

- ScheduledAchTransfers
  - `page` PageMetadata
    - `nextOffset` string, nullable: Opaque offset identifier.
  - `scheduled_ach_transfers` ScheduledAchTransfer[], required: A list of scheduled ACH transfers for the account.
    - `id` string, uuid, required: Unique identifier for the scheduled transfer.
    - `status` 'pending' | 'pending_approval' | 'canceled' | 'processing' | 'error' | 'sent' | 'returned' | 'void', required
    - `amount` string, required: The amount to be transferred.
    - `description` string, nullable: A brief description of the transfer.
    - `schedule_description` string, nullable: A human-readable description of the schedule (e.g. "once on Dec 29, 2025").
    - `counterparty_id` string, uuid, required: The ID of the counterparty.
    - `rrule` string, required: The recurrence rule (RFC 5545) for the schedule.
    - `first_occurrence` string, date-time, required: ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
    - `transfer_type` 'book' | 'usdc' | 'usdt' | 'pyusd' | 'cash' | 'usdg' | 'path_usd' | 'ach' | 'wire' | 'international', required: The rail a transfer moves on, as the customer API reports it.
    - `metadata` object, nullable: The metadata attached when this schedule was created, unchanged. Every payment the schedule sends carries it too. `null` when none was attached.

## Other responses

- `400`: The request could not be processed.
- `401`: Authentication failed.
- `403`: The API key is not authorized for this operation, or the user of a global API key is an admin or controller without approved KYC. The KYC case returns the message `KYC is required for controllers and admins.` until that user completes KYC in the Meow dashboard.
- `429`: Too many requests.

---

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