Skip to main content
GET
/
v0
/
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-otp: <api-key>' \
  --header 'api-sign: <api-key>'
{
  "result": [
    {
      "id": "TABCDEF234567A",
      "type": "request_withdrawal",
      "type_label": "Request Withdrawal",
      "state": "pending",
      "created_at": "1736942096",
      "updated_at": "1736942196",
      "expires_at": "1737028496",
      "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",
      "description": "Withdraw 1.5 BTC to external address",
      "reviewer_statistics_label": "standard",
      "instruction_types": [
        "tet_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,
  "start": 0
}

Authorizations

​
api-key
string
header
required
​
api-sign
string
header
required
​
api-nonce
string
header
required
​
api-otp
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
number<double>

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

Example:

100

​
offset
number<double>

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
string[]

Restrict the result set to tasks whose action type matches one of the supplied values (e.g. request_withdrawal, create_vault, subquorum_update). Multiple values are OR-ed.

​
created_at_from
string<date-time>

Include only tasks created at or after this timestamp (inclusive).

​
created_at_to
string<date-time>

Include only tasks created at or before this timestamp (inclusive).

​
updated_at_from
string<date-time>

Include only tasks last updated at or after this timestamp (inclusive).

​
updated_at_to
string<date-time>

Include only tasks last updated at or before this timestamp (inclusive).

​
expires_at_from
string<date-time>

Include only tasks expiring at or after this timestamp (inclusive).

​
expires_at_to
string<date-time>

Include only tasks expiring at or before this timestamp (inclusive).

​
order_by
string

Column to sort the result set by. One of id, state, vault_id, created_at, updated_at, expires_at. Defaults to created_at.

Example:

"created_at"

​
order_dir
string

Sort direction. Either asc or desc. Defaults to desc.

Example:

"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.

​
total
number<double>
required

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

Example:

42

​
start
number<double>
required

Offset at which the returned page begins. Matches the offset request parameter.

Example:

0