> ## Documentation Index
> Fetch the complete documentation index at: https://cobo.com/developers/llms.txt
> Use this file to discover all available pages before exploring further.

# List approval details

> This operation retrieves comprehensive approval information for transactions, including approval status, reviewer details, signatures, and approval history. You can filter the results by transaction IDs, Cobo IDs, or request IDs. 

This operation is commonly used to monitor approval progress and identify delays in multi-signature workflows.


<Tip>
  Try [Cobo WaaS Skill](/v2/guides/overview/cobo-waas-skill) in your AI coding assistant (Claude Code, Cursor, etc.). Describe your needs in natural language to auto-generate production-ready SDK code and debug faster 🚀
</Tip>

<RequestExample>
  ```python Python theme={null}
  import cobo_waas2
  from cobo_waas2.models.approval_detail import ApprovalDetail
  from cobo_waas2.rest import ApiException
  from pprint import pprint

  # See configuration.py for a list of all supported configurations.
  configuration = cobo_waas2.Configuration(
      # Replace `<YOUR_PRIVATE_KEY>` with your private key
      api_private_key="<YOUR_PRIVATE_KEY>",
      # Select the development environment. To use the production environment, change the URL to https://api.cobo.com/v2.
      host="https://api.dev.cobo.com/v2",
  )
  # Enter a context with an instance of the API client
  with cobo_waas2.ApiClient(configuration) as api_client:
      # Create an instance of the API class
      api_instance = cobo_waas2.TransactionsApi(api_client)
      transaction_ids = (
          "f47ac10b-58cc-4372-a567-0e02b2c3d479,557918d2-632a-4fe1-932f-315711f05fe3"
      )
      cobo_ids = "20231213122855000000000000000000,20231213122955000000000000000000"
      request_ids = (
          "web_send_by_user_327_1610444045047,web_send_by_user_327_1610444045048"
      )

      try:
          # List approval details
          api_response = api_instance.list_approval_details(
              transaction_ids=transaction_ids, cobo_ids=cobo_ids, request_ids=request_ids
          )
          print("The response of TransactionsApi->list_approval_details:\n")
          pprint(api_response)
      except Exception as e:
          print("Exception when calling TransactionsApi->list_approval_details: %s\n" % e)

  ```

  ```java Java theme={null}
  // Import classes:
  import com.cobo.waas2.ApiClient;
  import com.cobo.waas2.ApiException;
  import com.cobo.waas2.Configuration;
  import com.cobo.waas2.Env;
  import com.cobo.waas2.api.TransactionsApi;
  import com.cobo.waas2.model.*;

  public class Example {
    public static void main(String[] args) {
      ApiClient defaultClient = Configuration.getDefaultApiClient();
      // Select the development environment. To use the production environment, replace `Env.DEV` with
      // `Env.PROD
      defaultClient.setEnv(Env.DEV);

      // Replace `<YOUR_PRIVATE_KEY>` with your private key
      defaultClient.setPrivKey("<YOUR_PRIVATE_KEY>");
      TransactionsApi apiInstance = new TransactionsApi();
      String transactionIds =
          "f47ac10b-58cc-4372-a567-0e02b2c3d479,557918d2-632a-4fe1-932f-315711f05fe3";
      String coboIds = "20231213122855000000000000000000,20231213122955000000000000000000";
      String requestIds = "web_send_by_user_327_1610444045047,web_send_by_user_327_1610444045048";
      try {
        List<ApprovalDetail> result =
            apiInstance.listApprovalDetails(transactionIds, coboIds, requestIds);
        System.out.println(result);
      } catch (ApiException e) {
        System.err.println("Exception when calling TransactionsApi#listApprovalDetails");
        System.err.println("Status code: " + e.getCode());
        System.err.println("Reason: " + e.getResponseBody());
        System.err.println("Response headers: " + e.getResponseHeaders());
        e.printStackTrace();
      }
    }
  }

  ```

  ```go Go theme={null}
  package main

  import (
  	"context"
  	"fmt"
  	coboWaas2 "github.com/CoboGlobal/cobo-waas2-go-sdk/cobo_waas2"
  	"github.com/CoboGlobal/cobo-waas2-go-sdk/cobo_waas2/crypto"
  	"os"
  )

  func main() {
  	transactionIds := "f47ac10b-58cc-4372-a567-0e02b2c3d479,557918d2-632a-4fe1-932f-315711f05fe3"
  	coboIds := "20231213122855000000000000000000,20231213122955000000000000000000"
  	requestIds := "web_send_by_user_327_1610444045047,web_send_by_user_327_1610444045048"

  	configuration := coboWaas2.NewConfiguration()
  	// Initialize the API client
  	apiClient := coboWaas2.NewAPIClient(configuration)
  	ctx := context.Background()

  	// Select the development environment. To use the production environment, replace coboWaas2.DevEnv with coboWaas2.ProdEnv
  	ctx = context.WithValue(ctx, coboWaas2.ContextEnv, coboWaas2.DevEnv)
  	// Replace `<YOUR_PRIVATE_KEY>` with your private key
  	ctx = context.WithValue(ctx, coboWaas2.ContextPortalSigner, crypto.Ed25519Signer{
  		Secret: "<YOUR_PRIVATE_KEY>",
  	})
  	resp, r, err := apiClient.TransactionsAPI.ListApprovalDetails(ctx).
  		TransactionIds(transactionIds).
  		CoboIds(coboIds).
  		RequestIds(requestIds).
  		Execute()
  	if err != nil {
  		fmt.Fprintf(
  			os.Stderr,
  			"Error when calling `TransactionsAPI.ListApprovalDetails``: %v\n",
  			err,
  		)
  		fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r)
  	}
  	// response from `ListApprovalDetails`: []ApprovalDetail
  	fmt.Fprintf(os.Stdout, "Response from `TransactionsAPI.ListApprovalDetails`: %v\n", resp)
  }

  ```

  ```javascript JavaScript theme={null}
  const CoboWaas2 = require("@cobo/cobo-waas2");
  // Initialize the API client
  const apiClient = CoboWaas2.ApiClient.instance;
  // Select the development environment. To use the production environment, replace `Env.DEV` with `Env.PROD`
  apiClient.setEnv(CoboWaas2.Env.DEV);
  // Replace `<YOUR_PRIVATE_KEY>` with your private key
  apiClient.setPrivateKey("<YOUR_PRIVATE_KEY>");
  // Call the API
  const apiInstance = new CoboWaas2.TransactionsApi();
  const opts = {
    transaction_ids:
      "f47ac10b-58cc-4372-a567-0e02b2c3d479,557918d2-632a-4fe1-932f-315711f05fe3",
    cobo_ids: "20231213122855000000000000000000,20231213122955000000000000000000",
    request_ids:
      "web_send_by_user_327_1610444045047,web_send_by_user_327_1610444045048",
  };
  apiInstance.listApprovalDetails(opts).then(
    (data) => {
      console.log("API called successfully. Returned data: " + data);
    },
    (error) => {
      console.error(error);
    },
  );

  ```
</RequestExample>


## OpenAPI

````yaml get /transactions/approval/details
openapi: 3.0.3
info:
  title: Cobo Wallet as a Service 2.0
  description: >
    The Cobo Wallet-as-a-Service (WaaS) 2.0 API is the latest version of Cobo's
    WaaS API offering. It enables you to access Cobo's full suite of crypto
    wallet technologies with powerful and flexible access controls. By
    encapsulating complex security protocols and streamlining blockchain
    interactions, this API allows you to concentrate on your core business
    activities without worrying about the safety of your assets. The WaaS 2.0
    API presents the following key features:


    - A unified API for Cobo's [all four wallet
    types](https://manuals.cobo.com/en/portal/introduction#an-all-in-one-wallet-platform)

    - Support for 80+ chains and 3000+ tokens

    - A comprehensive selection of webhook events

    - Flexible usage models for MPC Wallets, including [Organization-Controlled
    Wallets](https://manuals.cobo.com/en/portal/mpc-wallets/ocw/introduction)
    and [User-Controlled
    Wallets](https://manuals.cobo.com/en/portal/mpc-wallets/ucw/introduction)

    - Programmatic control of smart contract wallets such as Safe{Wallet} with
    fine-grained access controls

    - Seamlessly transfer funds across multiple exchanges, including Binance,
    OKX, Bybit, Deribit, and more


    For more information about the WaaS 2.0 API, see [Introduction to WaaS
    2.0](https://www.cobo.com/developers/v2/guides/overview/introduction).
  termsOfService: https://cobo.com/waas/tos/
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  contact:
    name: Cobo WaaS
    url: https://www.cobo.com/waas
    email: help@cobo.com
  version: 1.0.0
servers:
  - url: https://api.dev.cobo.com/v2
    description: Development environment
  - url: https://api.cobo.com/v2
    description: Production environment
security:
  - CoboAuth: []
tags:
  - name: Organizations
    description: Operations related to Organizations.
  - name: Wallets
    description: Operations related to all wallets.
  - name: Wallets - MPC Wallets
    description: Operations related to mpc wallet.
  - name: Wallets - Exchange Wallet
    description: Operations related to exchange wallet.
  - name: Wallets - Smart Contract Wallets
    description: Operations related to smart contract wallet.
  - name: Transactions
    description: Operations related to all transactions.
  - name: Developers - Webhooks
    description: Operations related to webhooks.
  - name: Stakings
    description: Operations related to staking.
  - name: OAuth
    description: Operations related to OAuth.
  - name: Developers
    description: Operations related to developers.
  - name: AddressBooks
    description: Operations related to address books.
  - name: TravelRule
    description: Operations related to travel rule.
  - name: GraphQL
    description: Operations related to executing GraphQL queries and mutations.
  - name: PrimeBroker
    description: Operations related to prime broker.
  - name: AppWorkflows
    description: Operations related to app workflow.
  - name: FeeStation
    description: Operations related to fee station.
  - name: Payment
    description: Operations related to payment.
  - name: Batch Payouts
    description: Operations related to batch payouts.
  - name: Tokenization
    description: Operations related to tokenization.
  - name: AutoSweep
    description: Operations related to auto sweep.
  - name: Compliance
    description: Operations related to compliance.
paths:
  /transactions/approval/details:
    get:
      tags:
        - Transactions
      summary: List approval details
      description: >
        This operation retrieves comprehensive approval information for
        transactions, including approval status, reviewer details, signatures,
        and approval history. You can filter the results by transaction IDs,
        Cobo IDs, or request IDs. 


        This operation is commonly used to monitor approval progress and
        identify delays in multi-signature workflows.
      operationId: list_approval_details
      parameters:
        - $ref: '#/components/parameters/optionalTransactionIdParam'
        - $ref: '#/components/parameters/optionalCoboIdParam'
        - $ref: '#/components/parameters/optionalRequestIDsParam'
      responses:
        '200':
          $ref: '#/components/responses/listApprovalDetailsResponse'
        4XX:
          $ref: '#/components/responses/badRequestError'
        5XX:
          $ref: '#/components/responses/internalServerError'
      security:
        - CoboAuth: []
        - OAuth2:
            - transaction.read
components:
  parameters:
    optionalTransactionIdParam:
      name: transaction_ids
      in: query
      required: false
      description: A list of transaction IDs, separated by comma.
      schema:
        type: string
      example: >-
        f47ac10b-58cc-4372-a567-0e02b2c3d479,557918d2-632a-4fe1-932f-315711f05fe3
    optionalCoboIdParam:
      name: cobo_ids
      in: query
      required: false
      description: >-
        A list of Cobo IDs, separated by comma. A Cobo ID can be used to track a
        transaction.
      schema:
        type: string
      example: 20231213122855000000000000000000,20231213122955000000000000000000
    optionalRequestIDsParam:
      name: request_ids
      in: query
      required: false
      description: A list of request IDs, separated by comma.
      schema:
        type: string
      example: web_send_by_user_327_1610444045047,web_send_by_user_327_1610444045048
  responses:
    listApprovalDetailsResponse:
      description: Details of the transaction approvals.
      content:
        application/json:
          schema:
            type: array
            items:
              $ref: '#/components/schemas/ApprovalDetail'
    badRequestError:
      description: >-
        Bad request. Your request contains malformed syntax or invalid
        parameters.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    internalServerError:
      description: Internal server error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    ApprovalDetail:
      type: object
      description: Details of the transaction approval.
      properties:
        transaction_id:
          type: string
          description: Transaction ID.
          format: uuid
          example: aff0e1cb-15b2-4e1f-9b9d-a9133715986f
        cobo_id:
          type: string
          description: Cobo ID used to track a transaction.
          example: '20231213122855000000000000000000'
        request_id:
          type: string
          description: Request ID used to track a transaction request.
          example: web_send_by_user_327_1610444045047
        address_owner:
          $ref: '#/components/schemas/RoleDetail'
        spender:
          $ref: '#/components/schemas/RoleDetail'
        approver:
          $ref: '#/components/schemas/RoleDetail'
    ErrorResponse:
      type: object
      description: The response of a failed request.
      required:
        - error_code
        - error_message
        - error_id
      properties:
        error_code:
          type: integer
          description: >-
            The error code. Refer to [Error codes and status
            codes](https://www.cobo.com/developers/v2/api-references/error-codes)
            for more details.
        error_message:
          type: string
          description: The error description.
        error_id:
          type: string
          description: >-
            The error log ID. You can provide the error ID when submitting a
            ticket to help Cobo to locate the issue.
          example: 0b6ddf19083c4bd1a9ca01bec44b24dd
    RoleDetail:
      type: object
      description: Details of the role in a transaction approval.
      properties:
        result:
          $ref: '#/components/schemas/ApprovalTransactionResult'
        review_threshold:
          type: integer
          description: Minimum number of approvals required for this role.
          example: 2
        initiator:
          type: string
          description: The initiator of the transaction.
          example: test@gmail.com
        is_upgraded:
          type: boolean
          description: Indicates whether the transaction approval has been upgraded.
          example: false
        complete_time:
          type: string
          description: Time when the role completed the approval.
          example: '2023-12-13T04:28:55.000Z'
        user_details:
          type: array
          items:
            $ref: '#/components/schemas/ApprovalUserDetail'
    ApprovalTransactionResult:
      type: string
      enum:
        - Rejected
        - Pending
        - Approved
      x-enum-varnames:
        - REJECTED
        - PENDING
        - APPROVED
      example: Rejected
      description: |
        Result of transaction approval. Possible values include: 
          - `Rejected`: The transaction is rejected.
          - `Pending`: The transaction is pending approval.
          - `Approved`: The transaction is approved.
    ApprovalUserDetail:
      type: object
      description: |
        Details about a user involved in a transaction approval workflow.
      properties:
        name:
          type: string
          description: Name of the user who approved the transaction.
          example: John Doe
        email:
          type: string
          description: Email of the user.
          example: example@gmail.com
        pubkey:
          type: string
          description: Public key of the user.
          example: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
        signature:
          type: string
          description: Signature produced by the user for this approval.
          example: '0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef'
        statement_uuid:
          type: string
          description: UUID of the statement associated with this approval.
          format: uuid
          example: aff0e1cb-15b2-4e1f-9b9d-a9133715986f
        result:
          $ref: '#/components/schemas/ApprovalResult'
        approval_result_code:
          type: integer
          description: Integer value representing the result of the approval.
          example: 1
        created_time:
          type: integer
          description: Timestamp when the approval was created.
          example: 1610444045
        expired_time:
          type: integer
          description: The timestamp when the approval was expired.
          example: 1610444165
        template_version:
          type: string
          description: Version of the template used for the transaction approval.
          example: 1.0.0
        header_title:
          type: string
          description: Display title used in the transaction approval.
          example: Transaction Approval
        is_for_sign:
          type: boolean
          description: |
            Indicates whether this approval requires signing:
            - `true`: The user must sign the transaction.
            - `false`: The user only needs to approve or reject without signing.
          example: true
        show_info:
          type: string
          description: Additional information to show for the transaction approval.
          example: >-
            {'org_name': 'Cobo', 'wallet_name': 'Cobo Wallet', 'environment':
            'Prod'}
        language:
          type: string
          description: Language used for the transaction approval.
          example: en
        message_version:
          type: string
          description: Version of the message format used for the transaction approval.
          example: 1.0.0
        message:
          type: string
          description: Message associated with the transaction approval.
          example: Please approve the transaction.
        extra_message:
          type: string
          description: >-
            Any additional message or information related to the transaction
            approval.
          example: Please review the transaction details carefully.
    ApprovalResult:
      type: string
      enum:
        - Approved
        - Rejected
      x-enum-varnames:
        - APPROVED
        - REJECTED
      example: Approved
      description: >
        Approval result for this user in the transaction approval. Possible
        values include: 
          - `Approved`: The transaction is approved.
          - `Rejected`: The transaction is rejected.
  securitySchemes:
    CoboAuth:
      type: apiKey
      in: header
      name: BIZ-API-KEY
      description: >
        The API key. For more details, refer to [API
        key](https://www.cobo.com/developers/v2/guides/overview/cobo-auth#api-key).


        In the API playground, enter your [API
        secret](https://www.cobo.com/developers/v2/guides/overview/cobo-auth#api-secret),
        and your API key will be accordingly calculated.
    OAuth2:
      type: oauth2
      description: >-
        The [Org Access
        Token](https://www.cobo.com/developers/v2/apps/org-access-tokens). Use
        this authorization method only if you are developing Cobo Portal Apps
        for installation and use across different organizations.
      flows:
        authorizationCode:
          authorizationUrl: https://auth.cobo.com/authorize
          tokenUrl: https://auth.cobo.com/oauth/token
          scopes:
            address_book.read: Read address book
            api_key.read: Read API key information
            callback.read: Read callback message
            callback.resend: Resend callback message
            wallet.create: Create wallet
            wallet.read: Read wallet information
            wallet.update: Update wallet information
            wallet.delete: Delete wallet information
            wallet.create_address: Create wallet address
            wallet.manage_utxo: Manage UTXO
            mpc_project.create: Create MPC project
            mpc_project.read: Read MPC project information
            mpc_project.update: Update MPC project information
            mpc_vault.create: Create MPC Vault
            mpc_vault.read: Read MPC Vault information
            mpc_vault.update: Update MPC Vault information
            mpc_key_group.create: Create MPC key group
            mpc_key_group.read: Read MPC key group information
            mpc_key_group.update: Update MPC key group information
            mpc_key_group.delete: Delete MPC key group information
            transaction.read: Read transaction information
            transaction.withdraw: Make withdrawals
            transaction.estimate_fee: Estimate transaction fee
            transaction.contract_call: Initiate contract calls
            transaction.message_sign: Initiate message signings
            transaction.stake: Stake assets
            transaction.unstake: Unstake assets
            transaction.unstake_withdraw: Withdraw unstaked assets
            transaction.manage: Manage ongoing transactions
            transaction.update: Update transaction notes
            travel_rule.read: Read travel rule information
            travel_rule.edit: Edit travel rule information
            webhook.read: Read webhook URLs/events
            webhook.edit: Edit webhook URLs
            webhook.resend: Resend webhook events
            payment_orders_payin.create: Create pay-in order
            payment_orders_payin.read: Read pay-in order information
            payment_orders_payin.update: Update pay-in order
            payment_orders_refund.create: Create payment refund order
            payment_orders_refund.read: Read payment refund order information
            payment_settlement.create: Create payment settlement request
            payment_settlement.read: Read payment settlement request information
            payment_merchant.create: Create payment merchant
            payment_merchant.read: Read payment merchant information
            payment_merchant.update: Update payment merchant
            payment_forced_sweep.create: Create payment force sweep request
            payment_forced_sweep.read: Read payment force sweep request information
            compliance_funds.refund: Refund compliance funds request
            compliance_funds.isolate: Isolate compliance funds request
            compliance_funds.unfreeze: Unfreeze compliance funds request
            compliance_funds.read: Read compliance funds request information
            compliance_kyt_review.update: Update KYT review status
            compliance_kyt_decisions.update: Update KYT decision status
            compliance_kyt_status.read: Read KYT screening status
            compliance_kya_screenings.create: Create KYA address screening requests
            compliance_kya_screenings.read: Read KYA address screening results

````