List the calling client's scheduled payments (ALPHA)

curl --request GET \
  --url https://api.platform.dakota.xyz/scheduled-payments \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.platform.dakota.xyz/scheduled-payments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.platform.dakota.xyz/scheduled-payments"

headers = {"x-api-key": "<api-key>"}

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

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.platform.dakota.xyz/scheduled-payments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

[
  {
    "id": "2vWxScheduled000000000000000",
    "wallet_id": "2vWxWallet000000000000000000",
    "amount": "10000",
    "asset": "USDC",
    "address": "0xa11ce00000000000000000000000000000000001",
    "network_id": "base-sepolia",
    "status": "scheduled",
    "scheduled_at": 1781481600
  }
]

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-identifier",
  "title": "Invalid Identifier",
  "status": 400,
  "detail": "invalid signer_id"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "agentic payments are not enabled"
}

Agentic Payments

List the calling client's scheduled payments (ALPHA)

Alpha — early access.

Returns the calling client’s scheduled payments (the ScheduledPayment primitive — all statuses, not just future ones), oldest due first. Each shows its funding wallet (the customer’s choice at acceptance); once executed, a row also carries the covering mandate and money-path transaction as audit. Narrow the collection with the optional customer_id, signer_id, wallet_id, mandate_id, and status filters; omit them all for the full client collection. The mandate_id filter naturally matches executed rows only (a row carries no mandate until it fires).

GET

scheduled-payments

curl --request GET \
  --url https://api.platform.dakota.xyz/scheduled-payments \
  --header 'x-api-key: <api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.platform.dakota.xyz/scheduled-payments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.platform.dakota.xyz/scheduled-payments"

headers = {"x-api-key": "<api-key>"}

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

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.platform.dakota.xyz/scheduled-payments"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

[
  {
    "id": "2vWxScheduled000000000000000",
    "wallet_id": "2vWxWallet000000000000000000",
    "amount": "10000",
    "asset": "USDC",
    "address": "0xa11ce00000000000000000000000000000000001",
    "network_id": "base-sepolia",
    "status": "scheduled",
    "scheduled_at": 1781481600
  }
]

{
  "type": "https://docs.dakota.xyz/api-reference/errors#invalid-identifier",
  "title": "Invalid Identifier",
  "status": 400,
  "detail": "invalid signer_id"
}

{
  "type": "https://docs.dakota.xyz/api-reference/errors#not-found",
  "title": "Not Found",
  "status": 404,
  "detail": "agentic payments are not enabled"
}

Authorizations

x-api-key

string

header

required

Query Parameters

customer_id

string

Only payments for this customer (the signer's owning agent's customer).

signer_id

string

Only payments bound to this signer.

wallet_id

string

Only payments funded from this wallet.

mandate_id

string

Only payments that executed under this mandate (mandate_id is stamped at fire time, so this matches executed rows only).

status

string

Comma-separated statuses to include, e.g. "scheduled,executed". Allowed values: scheduled, cancelled, executed, failed. Omit for all.

Response

Scheduled payments, oldest due first

string

signer_id

string

The signer (hosted agent) this payment fires under. Updatable via PATCH while scheduled.

wallet_id

string

The funding wallet this payment spends from (the customer's choice at acceptance; updatable via PATCH while scheduled).

mandate_id

string

AUDIT — the mandate that covered this payment at fire time. Absent until the payment executes (coverage is decided at fire time, not bound at rest).

wallet_transaction_id

string

AUDIT — the money-path transaction created when this payment fired. Absent until the payment executes.

amount

string

asset

string

failure_reason

string

Why the payment failed (e.g. the mandate gate's denied dimensions); absent unless status is failed.

recipient_id

string

The recipient this payment pays, when it was created from a destination. Absent for a direct-address payment (which carries no recipient).

destination_id

string

The REAL destination this payment settles to — a bank (for an offramp) or a crypto destination. For an auto-account (convert-and-forward) payment, address is the crypto DEPOSIT actually paid while this names the bank/crypto target, so a client can show which account the scheduled payment is for. Absent for a direct-address payment.

destination_type

enum<string>

The kind of the REAL destination (see destination_id). bank marks an offramp (the payment converts crypto to fiat and forwards via a bank rail); crypto a direct or cross-family crypto payout. Absent for a direct-address payment with no destination.

Available options:

bank,

crypto

destination_label

string

A human label for the real destination — e.g. "Chase ••••5432" for a bank, or a shortened address for crypto — so a client can show which account the payment settles to without a second lookup. Absent when unresolved.

destination_rail

string

For a bank destination, the payout rail (e.g. ach, fedwire, swift). Absent for crypto.

output_asset

string

The asset the recipient ULTIMATELY receives. For an offramp this is the fiat currency (e.g. USD) the deposit converts to; for a direct crypto payment it equals asset. Stablecoin conversion is 1:1, so the output AMOUNT equals amount.

output_network

string

For a crypto destination, the network the recipient ULTIMATELY receives on — for a cross-family swap this differs from network_id (the DEPOSIT network the wallet pays), e.g. output_network solana-devnet while network_id is base-sepolia. Equals network_id for a direct crypto payment; absent for a bank offramp (fiat has no network).

address

string

network_id

string

status

enum<string>

Available options:

scheduled,

cancelled,

executed,

failed

executed_at

integer<int64>

scheduled_at

integer<int64>

Accept instructions — actuate proposals (ALPHA)Schedule a payment directly (ALPHA)

⌘I

API documentation

Customers

Wallets

Transactions

Recipients

Accounts

Auto Transactions

Onboarding

Policies

Signer Groups

Authentication

Users

Webhooks

Events

Info

Sandbox

Self Serve

Agentic Payments

Mandates

Insights

Payouts

List the calling client's scheduled payments (ALPHA)

Authorizations

Query Parameters

Response