List tasks

List tasks

curl --request GET \
  --url https://api.kraken.com/v0/insto/custody/tasks \
  --header 'api-key: <api-key>' \
  --header 'api-nonce: <api-key>' \
  --header 'api-sign: <api-key>'

import requests

url = "https://api.kraken.com/v0/insto/custody/tasks"

headers = {
    "api-key": "<api-key>",
    "api-sign": "<api-key>",
    "api-nonce": "<api-key>"
}

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

print(response.text)

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

fetch('https://api.kraken.com/v0/insto/custody/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://api.kraken.com/v0/insto/custody/tasks"

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

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

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

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

	fmt.Println(string(body))

}

{
  "result": [
    {
      "task_id": "TABCDEF234567A",
      "type": "normalized_task",
      "state": "pending",
      "created_at": "2026-01-15T12:34:56Z",
      "updated_at": "2026-01-15T12:35:56Z",
      "expires_at": "2026-01-16T12:34:56Z",
      "initiator": {
        "full_name": "Jane Doe",
        "role": "admin",
        "ip_address": "203.0.113.42",
        "iiban": "ABCD EFGH IJKL MNOP"
      },
      "quorum_type": "vault",
      "can_review": true,
      "current_user_decision": "undecided",
      "reviewer_statistics_label": "standard",
      "instruction_types": [
        "request_withdrawal"
      ],
      "approval_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "reviewer_statistics": {
        "approved": 1,
        "denied": 0,
        "undecided": 2,
        "current_count": 3,
        "required_quorum": 2
      },
      "vault_info": {
        "id": "VABCDEF234567A",
        "name": "Treasury Vault",
        "status": "active",
        "subquorum_config": {
          "groups": [
            {
              "id": "11111111-2222-4333-8444-555555555555",
              "required": 2,
              "members": [
                {
                  "iiban": "ABCD EFGH IJKL MNOP",
                  "full_name": "Jane Doe",
                  "email": "jane.doe@example.com",
                  "role": "admin"
                }
              ]
            }
          ]
        }
      },
      "subquorum_snapshot": {
        "groups": [
          {
            "id": "11111111-2222-4333-8444-555555555555",
            "required": 2,
            "members": [
              {
                "iiban": "ABCD EFGH IJKL MNOP",
                "full_name": "Jane Doe",
                "email": "jane.doe@example.com",
                "role": "admin"
              }
            ]
          }
        ]
      },
      "subquorum_approvals": [
        {
          "group_id": "11111111-2222-4333-8444-555555555555",
          "approved_iibans": [
            "ABCD EFGH IJKL MNOP"
          ]
        }
      ]
    }
  ],
  "total": 42
}

{
  "type": "tag:kraken.com,2025:BadRequest",
  "status": 400,
  "title": "Bad Request",
  "data": {
    "message": "Unknown filter value for state: 'archived'."
  },
  "detail": "Request failed validation.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:PermissionDenied",
  "status": 403,
  "title": "Forbidden",
  "data": {
    "message": "Caller lacks access to the requested task, vault, or organization scope."
  },
  "detail": "The caller is not authorized to perform this action.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:gateway/ReadUpstream",
  "status": 500,
  "title": "Internal Server Error",
  "data": "<unknown>",
  "detail": "Failed to read response from upstream custody service.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:gateway/Connect",
  "status": 503,
  "title": "Service Unavailable",
  "data": {},
  "detail": "Failed to connect to upstream custody service.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

GET

insto

custody

tasks

List tasks

curl --request GET \
  --url https://api.kraken.com/v0/insto/custody/tasks \
  --header 'api-key: <api-key>' \
  --header 'api-nonce: <api-key>' \
  --header 'api-sign: <api-key>'

import requests

url = "https://api.kraken.com/v0/insto/custody/tasks"

headers = {
    "api-key": "<api-key>",
    "api-sign": "<api-key>",
    "api-nonce": "<api-key>"
}

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

print(response.text)

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

fetch('https://api.kraken.com/v0/insto/custody/tasks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

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

func main() {

	url := "https://api.kraken.com/v0/insto/custody/tasks"

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

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

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

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

	fmt.Println(string(body))

}

{
  "result": [
    {
      "task_id": "TABCDEF234567A",
      "type": "normalized_task",
      "state": "pending",
      "created_at": "2026-01-15T12:34:56Z",
      "updated_at": "2026-01-15T12:35:56Z",
      "expires_at": "2026-01-16T12:34:56Z",
      "initiator": {
        "full_name": "Jane Doe",
        "role": "admin",
        "ip_address": "203.0.113.42",
        "iiban": "ABCD EFGH IJKL MNOP"
      },
      "quorum_type": "vault",
      "can_review": true,
      "current_user_decision": "undecided",
      "reviewer_statistics_label": "standard",
      "instruction_types": [
        "request_withdrawal"
      ],
      "approval_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d",
      "reviewer_statistics": {
        "approved": 1,
        "denied": 0,
        "undecided": 2,
        "current_count": 3,
        "required_quorum": 2
      },
      "vault_info": {
        "id": "VABCDEF234567A",
        "name": "Treasury Vault",
        "status": "active",
        "subquorum_config": {
          "groups": [
            {
              "id": "11111111-2222-4333-8444-555555555555",
              "required": 2,
              "members": [
                {
                  "iiban": "ABCD EFGH IJKL MNOP",
                  "full_name": "Jane Doe",
                  "email": "jane.doe@example.com",
                  "role": "admin"
                }
              ]
            }
          ]
        }
      },
      "subquorum_snapshot": {
        "groups": [
          {
            "id": "11111111-2222-4333-8444-555555555555",
            "required": 2,
            "members": [
              {
                "iiban": "ABCD EFGH IJKL MNOP",
                "full_name": "Jane Doe",
                "email": "jane.doe@example.com",
                "role": "admin"
              }
            ]
          }
        ]
      },
      "subquorum_approvals": [
        {
          "group_id": "11111111-2222-4333-8444-555555555555",
          "approved_iibans": [
            "ABCD EFGH IJKL MNOP"
          ]
        }
      ]
    }
  ],
  "total": 42
}

{
  "type": "tag:kraken.com,2025:BadRequest",
  "status": 400,
  "title": "Bad Request",
  "data": {
    "message": "Unknown filter value for state: 'archived'."
  },
  "detail": "Request failed validation.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:PermissionDenied",
  "status": 403,
  "title": "Forbidden",
  "data": {
    "message": "Caller lacks access to the requested task, vault, or organization scope."
  },
  "detail": "The caller is not authorized to perform this action.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:gateway/ReadUpstream",
  "status": 500,
  "title": "Internal Server Error",
  "data": "<unknown>",
  "detail": "Failed to read response from upstream custody service.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

{
  "type": "tag:kraken.com,2025:gateway/Connect",
  "status": 503,
  "title": "Service Unavailable",
  "data": {},
  "detail": "Failed to connect to upstream custody service.",
  "instance": "https://debug.kraken.com/req/01HXYZABCDEF"
}

Authorizations

api-key

string

header

required

api-sign

string

header

required

api-nonce

string

header

required

Query Parameters

org_iiban

string

Restrict the result set to tasks owned by the specified organization, identified by its 16-char IIBAN. Defaults to the caller's organization when omitted.

Example:

"ABCD EFGH IJKL MNOP"

limit

integer<int32>

Maximum number of tasks to return in the page. Defaults to 100 when omitted.

Example:

100

offset

integer<int32>

Number of tasks to skip before the page begins, used together with limit for offset-based pagination. Defaults to 0 when omitted.

Example:

0

state

string[]

Restrict the result set to tasks in one or more lifecycle states. Allowed values: pending, approved, rejected, denied (alias of rejected), canceled, expired, failed, executed.

current_user_decision

string

Restrict the result set to tasks for which the caller has made the specified decision. One of undecided, approved, denied.

Example:

"undecided"

task_id

string[]

Restrict the result set to the supplied task IDs. Each value is a T-prefixed 14-char base32 identifier.

approval_id

string[]

Restrict the result set to tasks linked to the supplied approval UUIDs.

vault_id

string[]

Restrict the result set to tasks scoped to the supplied vault IDs. Each value is a V-prefixed 14-char base32 identifier with a final check character.

action

enum<string>[]

Restrict the result set to tasks that contain one of the supplied action types. Accepts only the singular action names listed below (for example request_withdrawal, create_vault, update_subquorum). Multiple values are OR-ed.

Available options:

update_subquorum,

update_vault_user,

update_vault_policy,

request_withdrawal,

remove_org_user,

create_user,

request_staking_allocation,

update_withdrawal_address,

update_user_permission,

create_vault,

update_vault,

update_domain_policy,

update_user_status,

request_transfer_to_spot,

create_api_user,

update_api_user,

request_staking_deallocation,

request_custody_transfer_to_spot,

request_pledge,

request_pledge_release

created_at_from

string<date-time>

Include only tasks created at or after this RFC 3339 UTC timestamp (inclusive), e.g. 2026-01-15T12:34:56Z; the Z (UTC) offset is required.

created_at_to

string<date-time>

Include only tasks created at or before this RFC 3339 UTC timestamp (inclusive), e.g. 2026-01-15T12:34:56Z; the Z (UTC) offset is required.

updated_at_from

string<date-time>

Include only tasks last updated at or after this RFC 3339 UTC timestamp (inclusive), e.g. 2026-01-15T12:34:56Z; the Z (UTC) offset is required.

updated_at_to

string<date-time>

Include only tasks last updated at or before this RFC 3339 UTC timestamp (inclusive), e.g. 2026-01-15T12:34:56Z; the Z (UTC) offset is required.

expires_at_from

string<date-time>

Include only tasks expiring at or after this RFC 3339 UTC timestamp (inclusive), e.g. 2026-01-15T12:34:56Z; the Z (UTC) offset is required.

expires_at_to

string<date-time>

Include only tasks expiring at or before this RFC 3339 UTC timestamp (inclusive), e.g. 2026-01-15T12:34:56Z; the Z (UTC) offset is required.

sort

string

Ordering as a single field:direction token (direction optional, defaults to desc). Only one column is supported. Allowed fields: id, state, vault_id, created_at, updated_at, expires_at. Defaults to created_at:desc.

Example:

"created_at:desc"

Response

Page of task summaries matching the requested filters.

result

object[]

required

Page of task summaries matching the requested filters, ordered by the requested column.

Show child attributes

total

integer<int32>

required

Total number of tasks matching the filters, prior to pagination.

Example:

42

Create withdrawal fee quote Create task

⌘I

Assets (v0)

Organizations (v0)

Vaults (v0)

Deposits (v0)

Withdrawals (v0)

Tasks (v0)

Transactions (v0)

Authorizations

Query Parameters

Response