---
title: "List runs for a scheduled fiat withdrawal"
method: GET
path: "/v3/withdrawals/fiat/schedules/{scheduleId}/runs"
tags: ["Fiat withdrawal"]
---

# List runs for a scheduled fiat withdrawal

`GET /v3/withdrawals/fiat/schedules/{scheduleId}/runs`

## Request

- Base URL: `https://confirmo.net/api`
- URL: `https://confirmo.net/api/v3/withdrawals/fiat/schedules/{scheduleId}/runs`
- Auth: HTTP bearer

Returns the run history for a single schedule, ordered from newest to oldest. Returns 404 when the schedule does not exist or does not belong to the caller's merchant.

## Path parameters

- `scheduleId` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Runs returned successfully.

- DataPageToFiatWithdrawalScheduleRunDetailRestResponse
  - `data` FiatWithdrawalScheduleRunDetailRestResponse[]: The collection of items.
    - `balanceAtRun` number: Available balance (outstanding - blocked) observed at run time. Null when the cycle short-circuited before reading the balance (e.g. withdrawal account not whitelisted).
    - `minimumAmount` number: Snapshot of the schedule's minimum amount at run time. Null when no minimum was configured.
    - `minimumBalance` number: Snapshot of the schedule's minimum balance at run time.
    - `outcome` 'EXECUTION_ERROR' | 'SKIPPED_ABOVE_PROVIDER_LIMIT' | 'SKIPPED_AMOUNT_BELOW_FEE' | 'SKIPPED_BELOW_MINIMUM_AMOUNT' | 'SKIPPED_BELOW_MINIMUM_BALANCE' | 'SKIPPED_BELOW_TRANSACTION_LIMIT' | 'SKIPPED_MERCHANT_STATUS_FORBIDS' | 'SKIPPED_WALLET_NOT_WHITELISTED' | 'WITHDRAWAL_INITIATED' | 'WITHDRAWAL_INITIATED_AT_TRANSACTION_LIMIT': Outcome of the run.
    - `ranAt` integer: When the sweep job evaluated the schedule for this cycle.
    - `remainingBalance` number: Balance left after the amount withdrawn and its fee. Populated only when outcome is WITHDRAWAL_INITIATED_AT_TRANSACTION_LIMIT, when the amount was capped at the maximum per withdrawal.
    - `runId` string: ID of the run.
    - `sweptAmount` number: Amount withdrawn this cycle, or the sweep amount found too small. Populated when outcome is WITHDRAWAL_INITIATED, WITHDRAWAL_INITIATED_AT_TRANSACTION_LIMIT, SKIPPED_BELOW_MINIMUM_AMOUNT or SKIPPED_BELOW_TRANSACTION_LIMIT.
    - `withdrawalId` string: ID of the withdrawal created by this run. Always present for WITHDRAWAL_INITIATED and WITHDRAWAL_INITIATED_AT_TRANSACTION_LIMIT. May be present for EXECUTION_ERROR if the failure occurred after the withdrawal initiation row was created. Absent for skipped runs.
  - `limit` integer: The number of returned items.
  - `offset` integer: The number of skipped items.
  - `order` string: The sort column and the order of returned items.
  - `query` string: The searched string in items.
  - `totalCount` integer: The total number of items owned by the merchant.

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Schedule not found.
- `409`: Conflict

---

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