Get a scheduled payment

curl --request GET \
  --url https://api.panoflow.io/v1/scheduled-payments/{scheduled_payment_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.panoflow.io/v1/scheduled-payments/{scheduled_payment_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.panoflow.io/v1/scheduled-payments/{scheduled_payment_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "id": "sch_01JC8XE6SZAEAVSNTCPM5Q1NXW",
  "object": "scheduled_payment",
  "name": "Warehouse rent",
  "status": "active",
  "recipient_id": "rcp_01JCQY77ZXYYK596NGYA1DQ91K",
  "counterparty_name": "Garki Properties",
  "bank_account": {
    "account_number": "0021345516",
    "bank_code": "221",
    "bank_name": "Stanbic IBTC",
    "account_name": "GARKI PROPERTIES LTD"
  },
  "source_account": {
    "id": "acc_01JCWPQ5E6EYCNDY0YP57RCYBV",
    "name": "Naira · Main",
    "currency": "NGN",
    "account_number_last4": "6789"
  },
  "amount": {
    "amount": 275000000,
    "currency": "NGN"
  },
  "narration": "Warehouse rent",
  "schedule": {
    "frequency": "monthly",
    "interval": 3,
    "day_of_month": 1,
    "start_on": "2027-01-01"
  },
  "schedule_description": "Every 3 months",
  "next_run_on": "2027-01-01",
  "next_transfer_id": "trf_01JCNPZX45HY43KWJRP1XPA7Z3",
  "run_count": 0,
  "created_by": {
    "type": "user",
    "id": "usr_01JCMZ9J92V81E5128Q6RW31FZ",
    "name": "Adaeze Okafor"
  },
  "created_at": "2026-10-28T08:40:00Z",
  "updated_at": "2026-10-28T08:40:00Z"
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

GET

scheduled-payments

{scheduled_payment_id}

Get a scheduled payment

curl --request GET \
  --url https://api.panoflow.io/v1/scheduled-payments/{scheduled_payment_id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.panoflow.io/v1/scheduled-payments/{scheduled_payment_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.panoflow.io/v1/scheduled-payments/{scheduled_payment_id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "id": "sch_01JC8XE6SZAEAVSNTCPM5Q1NXW",
  "object": "scheduled_payment",
  "name": "Warehouse rent",
  "status": "active",
  "recipient_id": "rcp_01JCQY77ZXYYK596NGYA1DQ91K",
  "counterparty_name": "Garki Properties",
  "bank_account": {
    "account_number": "0021345516",
    "bank_code": "221",
    "bank_name": "Stanbic IBTC",
    "account_name": "GARKI PROPERTIES LTD"
  },
  "source_account": {
    "id": "acc_01JCWPQ5E6EYCNDY0YP57RCYBV",
    "name": "Naira · Main",
    "currency": "NGN",
    "account_number_last4": "6789"
  },
  "amount": {
    "amount": 275000000,
    "currency": "NGN"
  },
  "narration": "Warehouse rent",
  "schedule": {
    "frequency": "monthly",
    "interval": 3,
    "day_of_month": 1,
    "start_on": "2027-01-01"
  },
  "schedule_description": "Every 3 months",
  "next_run_on": "2027-01-01",
  "next_transfer_id": "trf_01JCNPZX45HY43KWJRP1XPA7Z3",
  "run_count": 0,
  "created_by": {
    "type": "user",
    "id": "usr_01JCMZ9J92V81E5128Q6RW31FZ",
    "name": "Adaeze Okafor"
  },
  "created_at": "2026-10-28T08:40:00Z",
  "updated_at": "2026-10-28T08:40:00Z"
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

{
  "error": {
    "response_code": "00",
    "type": "invalid_request",
    "code": "invalid_json",
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>",
    "doc_url": "<string>",
    "details": {}
  }
}

Authorizations

Authorization

string

header

required

Server API key, scoped. pk_test_ keys hit the sandbox tenant.

Headers

X-Request-Id

string

Optional client correlation id, up to 128 characters. It is not echoed: the response's X-Request-Id is always our own req_… id. We log your value with the request as client_request_id, so support can find a request by either id. A longer value is refused with 400 parameter_invalid.

Maximum string length: 128

Path Parameters

scheduled_payment_id

string

required

sch_…

Pattern: ^sch_[0-9A-HJKMNP-TV-Z]{26}$

Response

The scheduled payment.

A payment to a saved recipient on a schedule.

string

required

sch_…

object

string

required

Always scheduled_payment.

Allowed value: "scheduled_payment"

name

string

required

e.g. "Warehouse rent".

Maximum string length: 80

status

enum<string>

required

State of the schedule itself (its runs are transfers with MovementStatus). completed when a once schedule has run or end_on has passed.

Available options:

active,

paused,

canceled,

completed

recipient_id

string

required

rcp_…

source_account

object

required

Enough of a PanoFlow account to show it ("Naira · Main · ••••6789"). Full account in the Accounts API.

Show child attributes

amount

object

required

An amount in minor units (kobo, cents) with its currency. Never a decimal.

Show child attributes

schedule

object

required

When it runs. Examples: "Every Monday" = weekly, day_of_week: monday; "Monthly, on the 28th" = monthly, day_of_month: 28; "Every 3 months" = monthly, interval: 3. Runs at 08:00 Africa/Lagos. A day_of_month past the end of a month runs on the month's last day.

Show child attributes

schedule_description

string

required

Human text, e.g. "Every 3 months", "Every Monday", "Monthly, on the 28th".

run_count

integer

required

Runs so far.

Required range: x >= 0

created_by

object

required

Who did something. Shown in activity, approvals and the audit log.

Show child attributes

created_at

string<date-time>

required

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

updated_at

string<date-time>

required

RFC 3339, UTC.

Example:

"2026-10-27T08:41:00Z"

counterparty_name

string

The recipient's display name.

bank_account

object

The recipient's account.

Show child attributes

narration

string

Narration on every run.

next_run_on

string<date>

Next run date. Omitted when paused, canceled or completed.

Example:

"2026-11-07"

next_transfer_id

string

The scheduled transfer for the next run.

last_run

object

The most recent run, with its transfer's ISO 8583 outcome (ResponseOutcome).

Show child attributes

metadata

object

Up to 20 string keys (≤ 40 chars) with string values (≤ 500 chars). Returned on the resource and its events.

Show child attributes

Accounts & transactions

Payments

Collections

Payroll

Approvals

Webhooks & events

OAuth

Get a scheduled payment

Authorizations

Headers

Path Parameters

Response