---
title: "List Scheduled Payments"
method: GET
path: "/v1/scheduled-payments"
tags: ["Transactions"]
---

# List Scheduled Payments

`GET /v1/scheduled-payments`

## Query parameters

- `cursor` string, nullable
- `limit` integer, nullable
- `status` 'pending' | 'processing' | 'executed' | 'failed' | 'cancelled'

## Response `200`

Scheduled payments retrieved

- ExternalGetScheduledPaymentsResponse
  - `next_cursor` string, nullable
  - `scheduled_payments` ExternalScheduledPaymentItem[], required
    - `amount_in_cents` integer, required
    - `created_at` string, date-time, required — Record creation timestamp (UTC, RFC 3339).
    - `executed_at` string, date-time, nullable — Execution timestamp (UTC, RFC 3339). Null until the payment is processed.
    - `id` integer, required
    - `receiver` string, required
    - `scheduled_date` string, date, required — Scheduled execution date (`YYYY-MM-DD`).
    - `status` 'pending' | 'processing' | 'executed' | 'failed' | 'cancelled', required
    - `transaction_id` integer, nullable
    - `type` string, required

## Other responses

- `401` — Authentication failed
- `403` — Access denied
- `404` — No account found
- `500` — Internal server error

---

[API](https://skmtc.net/kiwify/apis/conta-digital-api.md) · [All operations](https://skmtc.net/kiwify/apis/conta-digital-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kiwify/conta-digital-api/revisions/5e009b25c245/schema)