> ## Documentation Index > Fetch the complete documentation index at: https://kraken-sandbox.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # List tasks > Retrieve review tasks that match the specified filter criteria. ## OpenAPI ````yaml /openapi/custody-rest.yaml post /0/private/ListCustodyTasks openapi: 3.0.0 info: title: REST API version: 1.1.0 description: '' servers: - url: https://api.kraken.com description: Production Server security: - API-Key: [] API-Sign: [] tags: - name: Portfolios - name: Transfers - name: Tasks paths: /0/private/ListCustodyTasks: post: tags: - Tasks summary: List tasks description: Retrieve review tasks that match the specified filter criteria. operationId: listCustodyTasks requestBody: $ref: '#/components/requestBodies/listCustodyTasks' responses: '200': content: application/json: schema: $ref: '#/components/schemas/listCustodyTasks' description: '' components: requestBodies: listCustodyTasks: content: application/json: schema: type: object properties: nonce: $ref: '#/components/schemas/nonce' filters: example: and: [] description: >- Specify a subset of filter items. All filter objects are `AND` combined. Inside a filter object all properties are `OR` combined. default: and: [] oneOf: - description: All elements are combined with `AND`. type: object title: and properties: and: type: array items: description: Filtering expressions with or expressions oneOf: - description: All elements are combined with `OR`. type: object title: or properties: or: type: array items: oneOf: - title: id description: Filter by id oneOf: - title: equals description: Field must match the filter exactly. type: object properties: type: type: string enum: - equals values: description: Exact values to match against type: array items: description: TaskId type: string pattern: ^T[A-Z2-7]{12}[ACEGIKMOQSUWY246]$ minLength: 14 maxLength: 14 by: type: string enum: - id required: - by - type - values - title: approval_id description: Filter by approval_id oneOf: - title: equals description: Field must match the filter exactly. type: object properties: type: type: string enum: - equals values: description: Exact values to match against type: array items: type: string by: type: string enum: - approval_id required: - by - type - values - title: vault_id description: Filter by vault_id oneOf: - title: equals description: Field must match the filter exactly. type: object properties: type: type: string enum: - equals values: description: Exact values to match against type: array items: description: VaultId type: string pattern: ^V[A-Z2-7]{12}[ACEGIKMOQSUWY246]$ minLength: 14 maxLength: 14 by: type: string enum: - vault_id required: - by - type - values - title: scope description: Filter by scope oneOf: - title: equals description: Field must match the filter exactly. type: object properties: type: type: string enum: - equals values: description: Exact values to match against type: array items: oneOf: - title: domain type: string enum: - domain - title: vault type: string enum: - vault by: type: string enum: - scope required: - by - type - values - title: state description: Filter by state oneOf: - title: equals description: Field must match the filter exactly. type: object properties: type: type: string enum: - equals values: description: Exact values to match against type: array items: description: Task status oneOf: - title: pending description: >- The task is still waiting for approvals and has not reached a quorum yet type: string enum: - pending - title: approved description: >- The task has reached the quorum, but has not been executed type: string enum: - approved - title: denied description: >- The task has been rejected and not reached the quorum type: string enum: - denied - title: canceled description: The task was canceled type: string enum: - canceled - title: expired description: The task expired type: string enum: - expired - title: executed description: >- The task has reached the quorum and has been successfully executed type: string enum: - executed - title: failed description: >- The task has reached the quorum, but has errored during execution type: string enum: - failed by: type: string enum: - state required: - by - type - values - title: action description: Filter by action oneOf: - title: equals description: Field must match the filter exactly. type: object properties: type: type: string enum: - equals values: description: Exact values to match against type: array items: description: Task action oneOf: - title: update_withdrawal_addresses type: string enum: - update_withdrawal_addresses - title: request_withdrawal description: Request a withdrawal from a vault type: string enum: - request_withdrawal - title: create_vault description: Create a new vault type: string enum: - create_vault - title: update_group_users description: Add/remove users to groups type: string enum: - update_group_users - title: update_role_users description: Add/remove users to roles type: string enum: - update_role_users - title: update_vault_users description: Add/remove users to a vault type: string enum: - update_vault_users - title: update_domain_policies description: Update specific domain policies type: string enum: - update_domain_policies - title: update_vault_policies description: Update a vault's specific policies type: string enum: - update_vault_policies - title: create_users description: >- Invite new users to the custody organization type: string enum: - create_users - title: update_vault description: >- Update vault meta information like its name type: string enum: - update_vault - title: update_status_users description: >- Enable/disable users in a custody organization type: string enum: - update_status_users - title: request_transfer_to_spot description: >- Request a transfer from a vault to a spot account type: string enum: - request_transfer_to_spot - title: create_group description: Create a new group type: string enum: - create_group - title: update_permission_users description: Update user permissions type: string enum: - update_permission_users - title: create_api_users description: Create new API key users type: string enum: - create_api_users - title: update_api_users description: Update existing API key users type: string enum: - update_api_users - title: update_vaults_users description: Add/remove users to vaults type: string enum: - update_vaults_users - title: request_allocation description: Request staking allocation type: string enum: - request_allocation - title: request_deallocation description: Request staking deallocation type: string enum: - request_deallocation by: type: string enum: - action required: - by - type - values - title: created_at description: Filter by created_at oneOf: - title: equals description: Field must match the filter exactly. type: object properties: type: type: string enum: - equals values: type: array items: title: UnixTimestamp description: Unix timestamp in seconds type: string maxLength: 13 by: type: string enum: - created_at required: - by - type - values - title: in description: >- A range uses closed intervals `[left, right]` with `left <= column <= right`. Not providing a `left` will result a left-unbounded intervals `(−∞, right]` and respectively not providing `right` will result in a right-unbounded interval `[left, ∞)`. type: object properties: type: type: string enum: - in left: nullable: true title: UnixTimestamp description: Unix timestamp in seconds type: string maxLength: 13 right: nullable: true title: UnixTimestamp description: Unix timestamp in seconds type: string maxLength: 13 by: type: string enum: - created_at required: - by - type - title: updated_at description: Filter by updated_at oneOf: - title: equals description: Field must match the filter exactly. type: object properties: type: type: string enum: - equals values: type: array items: title: UnixTimestamp description: Unix timestamp in seconds type: string maxLength: 13 by: type: string enum: - updated_at required: - by - type - values - title: in description: >- A range uses closed intervals `[left, right]` with `left <= column <= right`. Not providing a `left` will result a left-unbounded intervals `(−∞, right]` and respectively not providing `right` will result in a right-unbounded interval `[left, ∞)`. type: object properties: type: type: string enum: - in left: nullable: true title: UnixTimestamp description: Unix timestamp in seconds type: string maxLength: 13 right: nullable: true title: UnixTimestamp description: Unix timestamp in seconds type: string maxLength: 13 by: type: string enum: - updated_at required: - by - type - title: expires_at description: Filter by expires_at oneOf: - title: equals description: Field must match the filter exactly. type: object properties: type: type: string enum: - equals values: type: array items: title: UnixTimestamp description: Unix timestamp in seconds type: string maxLength: 13 by: type: string enum: - expires_at required: - by - type - values - title: in description: >- A range uses closed intervals `[left, right]` with `left <= column <= right`. Not providing a `left` will result a left-unbounded intervals `(−∞, right]` and respectively not providing `right` will result in a right-unbounded interval `[left, ∞)`. type: object properties: type: type: string enum: - in left: nullable: true title: UnixTimestamp description: Unix timestamp in seconds type: string maxLength: 13 right: nullable: true title: UnixTimestamp description: Unix timestamp in seconds type: string maxLength: 13 by: type: string enum: - expires_at required: - by - type - title: current_user_decision description: Filter by current_user_decision oneOf: - title: equals description: Field must match the filter exactly. type: object properties: type: type: string enum: - equals values: description: Exact values to match against type: array items: oneOf: - title: approved description: Task approved type: string enum: - approved - title: denied description: Task denied type: string enum: - denied - title: undecided description: Task has not been reviewed yet type: string enum: - undecided by: type: string enum: - current_user_decision required: - by - type - values required: - or required: - and pagination: $ref: '#/components/schemas/pagination' orderings: example: - by: created_at direction: desc description: >- Specify how to order the returned items. If a column in the `orderings` list contains `null` values, these are always sorted to the end. default: - by: created_at direction: desc type: array items: description: Result ordering type: object properties: by: description: |- Column to order by - `id`: Order by task ID - `vault_id`: Order by vault ID - `state`: Order by task's current state - `created_at`: Order by task creation date - `updated_at`: Order by task last updated date - `expires_at`: Order by task expiration date enum: - id - vault_id - state - created_at - updated_at - expires_at direction: $ref: '#/components/schemas/orderDirection' required: - by required: - nonce required: true schemas: listCustodyTasks: type: object description: See Kraken API documentation for full schema. additionalProperties: true nonce: description: Nonce used in construction of `API-Sign` header type: integer format: int64 pagination: description: Define which items will get returned default: limit: 100 offset: 0 type: object properties: limit: description: Number of records to retrieve type: integer format: uint32 minimum: 1 maximum: 1000 offset: description: Result Offset type: integer format: uint32 minimum: 0 required: - limit - offset orderDirection: description: | Ordering direction - `asc`: Return items in ascending order (first to last) - `desc`: Return items in descending order (last to first) default: desc type: string enum: - asc - desc securitySchemes: API-Key: type: apiKey description: The "API-Key" header should contain your API key. name: API-Key in: header API-Sign: type: apiKey description: >- Authenticated requests should be signed with the "API-Sign" header, using a signature generated with your private key, nonce, encoded payload, and URI path. name: API-Sign in: header ````