List payment intents

curl --request GET \
  --url https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents"

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

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

print(response.text)

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

fetch('https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "budget_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "spend_token_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "amount_cents": 123,
      "currency": "<string>",
      "counterparty": "<string>",
      "state": "pending",
      "failure_reason": "<string>",
      "resolved_by_sub": "<string>",
      "resolved_at": "2023-11-07T05:31:56Z",
      "idempotency_key": "<string>",
      "trace_id": "<string>",
      "ledger_transaction_id": "<string>",
      "decision_context": {},
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>",
  "summary": {
    "total": 123,
    "total_cents": 123
  }
}

{
  "error": {
    "message": "<string>",
    "code": "runtime_key_required"
  }
}

GET

control

workspaces

{workspace_slug}

payment_intents

List payment intents

curl --request GET \
  --url https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents"

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

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

print(response.text)

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

fetch('https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents"

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

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.kordio.io/control/v1/workspaces/{workspace_slug}/payment_intents")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "workspace_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "agent_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "budget_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "spend_token_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "amount_cents": 123,
      "currency": "<string>",
      "counterparty": "<string>",
      "state": "pending",
      "failure_reason": "<string>",
      "resolved_by_sub": "<string>",
      "resolved_at": "2023-11-07T05:31:56Z",
      "idempotency_key": "<string>",
      "trace_id": "<string>",
      "ledger_transaction_id": "<string>",
      "decision_context": {},
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>",
  "summary": {
    "total": 123,
    "total_cents": 123
  }
}

{
  "error": {
    "message": "<string>",
    "code": "runtime_key_required"
  }
}

Authorizations

Authorization

string

header

required

An identity bearer token for a person or your backend. Capabilities are per member, per workspace. This credential can manage the workspace and can never authorize an action as an agent.

Path Parameters

workspace_slug

string

required

Query Parameters

agent_id

string<uuid>

budget_id

string<uuid>

state

enum<string>

Available options:

pending,

requires_approval,

executed,

failed,

denied

agent_mode

enum<string>

Narrow to intents whose agent runs in this mode. Any other value is a 400, rather than a silent full listing.

Available options:

live,

test

sort

enum<string>

default:age

Order the whole matching set, not just the page. amount sorts by the intent's value, age by when it was created. An unrecognised value falls back to age.

Available options:

amount,

age

direction

enum<string>

default:desc

Direction for sort. An unrecognised value falls back to desc.

Available options:

asc,

desc

min_amount_cents

integer

Drop anything worth less than this. Applies to the summary as well as the page.

Required range: x >= 0

held_before

string<date-time>

Keep only what was created before this instant, for finding what has been waiting longest. A value that is not ISO 8601 is ignored rather than rejected.

limit

integer

default:50

Page size. Defaults to 50, clamped to 1..200.

Required range: 1 <= x <= 200

starting_after

string<uuid>

The id of the last record on the previous page. An unknown or foreign id is ignored and returns the first page.

Response

A page of payment intents, with a summary of the whole matching set.

data

object[]

required

Show child attributes

has_more

boolean

required

True when the page filled to the limit. A final page that exactly fills the limit still reports true; the next request returns an empty page.

next_cursor

string | null

required

Pass back as starting_after.

summary

object

Describes everything the filters matched, not the page that was returned, so a caller can show a true queue size without walking every page.

Show child attributes

Get started

Core concepts

Guides

Guarantees

Reference

Endpoints

List payment intents

Authorizations

Path Parameters

Query Parameters

Response