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

# List Scheduled Wire Transfers

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

## Request

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

Returns a list of scheduled wire 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

- ScheduledWireTransfers
  - `page` PageMetadata
    - `nextOffset` string, nullable: Opaque offset identifier.
  - `scheduled_wire_transfers` ScheduledWireTransfer[], required: A list of scheduled wire transfers for the account.
    - `id` string, uuid, required: Unique identifier for the scheduled wire.
    - `status` 'pending' | 'pending_approval' | 'canceled' | 'processing' | 'error' | 'sent' | 'returned' | 'void', required
    - `amount` string, required: Amount sent on each occurrence, in USD.
    - `instructions` string, nullable: Wire instructions sent to the receiving bank each time.
    - `purpose` string, nullable: The purpose of payment you stated when scheduling.
    - `schedule_description` string, nullable: A human-readable description of the schedule (e.g. "once on Dec 29, 2025").
    - `counterparty_id` string, uuid, required: Contact paid on each occurrence.
    - `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 wire 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/d69c02d46fa0?raw)