Get Approval Details

This content applies to WaaS 1.0 only. We highly recommend that you upgrade to WaaS 2.0.

This endpoint returns a JSON response with the transaction approval process data for a given transaction request ID. The endpoint requires authentication and takes a ‘request_id’ parameter in the GET request.

GET https://api.dev.cobo.com/v1/custody/mpc/get_approval_details

Python

request(
    "GET",
    "/v1/custody/mpc/get_approval_details/",
    {
        "request_id": "1716285866523",
    },
    api_key, api_secret, host
)

Response

{
  "success": true,
  "result": {
    "spender": {},
    "broker_user": {
      "role_result": 1,
      "review_threshold": 1,
      "user_details": {
        "51ae8dbdcf49a117e80b61ee278e4925cdf0aec29a51965da5421dd51ecaba9038373138a32a706507eb2de5112946aede58f9c996e02548e0a5a2246d46f342": {
          "result": 2,
          "signature": "d9db4fd719104d014d9ed6bcb79b959bd268d009c0da88f2120035aba4f2ee237389b283fad545ac756ffb2c2342d1be80a113a4dab6a486e3699cde4925663c",
          "last_time": "2024-05-24 06:40:23.792131+00:00",
          "language": "zh",
          "message_version": "1.0.1",
          "extra_message": "custody|3aM7ZZUr6ZKjtPekiz9fuFcehjGbYddW8vtLsUPvE5hXhe2gL9BJ4Ng5T9V4rEC1KXfc3cNtCPu4twcXDNPQ44eaVj8sU2jHQJ5m3jybaBZVXJFpC8DcqY1NkPppLCpTSvQCN9z7n|web_send_by_user_1475_1716532814022|1716532817"
        }
      }
    },
    "approver": {
      "role_result": -1,
      "review_threshold": 1,
      "user_details": {
        "51ae8dbdcf49a117e80b61ee278e4925cdf0aec29a51965da5421dd51ecaba9038373138a32a706507eb2de5112946aede58f9c996e02548e0a5a2246d46f342": {
          "result": 3,
          "signature": "0dec39cb9ac2909e037722ba753ea52342db33399d49226b1cf826e8fa0b92df440a42a623e78c7a2d3c6d90e71fd561dcfc7750531acb073a7903c50220b761",
          "last_time": "2024-05-24 06:42:32.660555+00:00",
          "language": "zh",
          "message_version": "1.0.1",
          "extra_message": "custody|3aM7ZZUr6ZKjtPekiz9fuFcehjGbYddW8vtLsUPvE5hXhe2gL9BJ4Ng5T9V4rEC1KXfc3cNtCPu4twcXDNPQ44eaVj8sU2jHQJ5m3jybaBZVXJFpC8DcqY1NkPppLCpTSvQCN9z7n|web_send_by_user_1475_1716532814022|1716532914"
        }
      }
    }
  }
}

Request

request_id · String · required

Transaction request ID

Response

success · bool

request successful or failed

result · object

Show object

spender · object

Show object

role_result · Int

approval result of the role, 0: WAITING, 1: APPROVED, -1: DECLINED

review_threshold · Int

review threshold

user_details · object

Show object

pubkey · object

Show object

result · Int

approval result of the user, 1: UNKNOWN, 2: APPROVED, 3 DECLINED, 4: IGNORED

signature · String

signature

last_time · String

last operation time

language · String

language

message_version · String

message version

extra_message · String

extra message

broker_user · object

Show object

role_result · Int

approval result of the role, 0: WAITING, 1: APPROVED, -1: DECLINED

review_threshold · Int

review threshold

user_details · object

Show object

pubkey · object

Show object

result · Int

approval result of the user, 1: UNKNOWN, 2: APPROVED, 3 DECLINED, 4: IGNORED

signature · String

signature

last_time · String

last operation time

language · String

language

message_version · String

message version

extra_message · String

extra message

approver · object

Show object

role_result · Int

approval result of the role, 0: WAITING, 1: APPROVED, -1: DECLINED

review_threshold · Int

review threshold

user_details · object

Show object

pubkey · object

Show object

result · Int

approval result of the user, 1: UNKNOWN, 2: APPROVED, 3 DECLINED, 4: IGNORED

signature · String

signature

last_time · String

last operation time

language · String

language

message_version · String

message version

extra_message · String

extra message

Python

request(
    "GET",
    "/v1/custody/mpc/get_approval_details/",
    {
        "request_id": "1716285866523",
    },
    api_key, api_secret, host
)

Response

{
  "success": true,
  "result": {
    "spender": {},
    "broker_user": {
      "role_result": 1,
      "review_threshold": 1,
      "user_details": {
        "51ae8dbdcf49a117e80b61ee278e4925cdf0aec29a51965da5421dd51ecaba9038373138a32a706507eb2de5112946aede58f9c996e02548e0a5a2246d46f342": {
          "result": 2,
          "signature": "d9db4fd719104d014d9ed6bcb79b959bd268d009c0da88f2120035aba4f2ee237389b283fad545ac756ffb2c2342d1be80a113a4dab6a486e3699cde4925663c",
          "last_time": "2024-05-24 06:40:23.792131+00:00",
          "language": "zh",
          "message_version": "1.0.1",
          "extra_message": "custody|3aM7ZZUr6ZKjtPekiz9fuFcehjGbYddW8vtLsUPvE5hXhe2gL9BJ4Ng5T9V4rEC1KXfc3cNtCPu4twcXDNPQ44eaVj8sU2jHQJ5m3jybaBZVXJFpC8DcqY1NkPppLCpTSvQCN9z7n|web_send_by_user_1475_1716532814022|1716532817"
        }
      }
    },
    "approver": {
      "role_result": -1,
      "review_threshold": 1,
      "user_details": {
        "51ae8dbdcf49a117e80b61ee278e4925cdf0aec29a51965da5421dd51ecaba9038373138a32a706507eb2de5112946aede58f9c996e02548e0a5a2246d46f342": {
          "result": 3,
          "signature": "0dec39cb9ac2909e037722ba753ea52342db33399d49226b1cf826e8fa0b92df440a42a623e78c7a2d3c6d90e71fd561dcfc7750531acb073a7903c50220b761",
          "last_time": "2024-05-24 06:42:32.660555+00:00",
          "language": "zh",
          "message_version": "1.0.1",
          "extra_message": "custody|3aM7ZZUr6ZKjtPekiz9fuFcehjGbYddW8vtLsUPvE5hXhe2gL9BJ4Ng5T9V4rEC1KXfc3cNtCPu4twcXDNPQ44eaVj8sU2jHQJ5m3jybaBZVXJFpC8DcqY1NkPppLCpTSvQCN9z7n|web_send_by_user_1475_1716532814022|1716532914"
        }
      }
    }
  }
}