--- title: "Get transaction requests ready for signature" method: GET path: "/api/v2/wallet/{walletId}/txrequests/awaitingsignature" tags: ["Transaction request"] --- # Get transaction requests ready for signature `GET /api/v2/wallet/{walletId}/txrequests/awaitingsignature` ## Path parameters - `walletId` string, required ## Query parameters - `limit` union - string - string, number - `txRequestIds` string[] - `walletPermissions` string[] - `signingStage` '1-eddsa' | '2-eddsa' | '3-eddsa' | '4-eddsa' | '1-ecdsa' | '2-ecdsa' | '3-ecdsa' | '1-ecdsa-mpcv2' | '2-ecdsa-mpcv2' | '3-ecdsa-mpcv2' | '4-ecdsa-mpcv2' | '1-eddsa-mpcv2' | '2-eddsa-mpcv2' | '3-eddsa-mpcv2' | '4-eddsa-mpcv2' - `prevId` string - `sortBy` 'id' | 'createdDate', nullable - `sortDirection` 'ASC' | 'DESC', nullable ## Response `200` OK - ListTxRequestAwaitingSignatureForWalletResponse - `txRequests` object[], required - `transactions` object[] - `state` 'initialized' | 'pendingSignature' | 'eddsaPendingCommitment' | 'eddsaPendingRShare' | 'eddsaPendingGShare' | 'ecdsaMPCv2Round1' | 'ecdsaMPCv2Round2' | 'ecdsaMPCv2Round3' | 'eddsaMPCv2Round1' | 'eddsaMPCv2Round2' | 'eddsaMPCv2Round3' | 'readyToCombineShares' | 'signed' | 'held' | 'delivered' | 'invalidSignature' | 'rejected', required — If supplied, only transaction request transaction state changes from the provided list will trigger notifications. If not provided, all transaction request transaction state changes will trigger notifications. - `unsignedTx` UnsignedTransaction, required - `parsedTx` ParsedTx, required - `inputs` object[], required - `valueString` string, required - `_id` string - `address` string - `chain` number - `derivationIndex` number - `index` number - `value` union - … - `minerFee` union, required - string - number - `outputs` object[], required - `valueString` string, required - `address` string - `change` boolean - `coinName` string - `data` string - `isPayGo` boolean - `value` union - … - `wallet` string - `walletV1` string - `baseAddress` string - `enterprise` string - `spendAmount` union, required - string - number - `gasPrice` number - `hasUnvalidatedData` boolean - `payGoFee` union - string - number - `spendAmounts` object[] - `type` string - `serializedTxHex` string, required — The unsigned transaction as a hex string. - `signableHex` string, required — The portion of a transaction used to generate a signature (may or may not be the same as serializedTxHex) as a hex string. - `derivationPath` string — A bip32 path. - `coinSpecific` object — Coin specific information. - `nonceAddress` string - `stakingAddress` string - `signature` string - `feeInfo` object - `fee` union, required - string - number - `feeString` string, required - `signatureShares` object[] - `vssProof` string — The VSS proof of the signature share - `privateShareProof` string — The private share proof - `publicShare` string — The public share - `from` 'user' | 'backup' | 'bitgo', required - `to` 'user' | 'backup' | 'bitgo', required - `share` string, required — The signature share - `commitmentShares` object[] - `type` 'commitment', required — The type of the commitment share - `from` 'user' | 'backup' | 'bitgo', required - `to` 'user' | 'backup' | 'bitgo', required - `share` string, required — The commitment share. - `txHash` string - `updatedDate` string, date-time - `createdDate` string, date-time - `messages` object[] - `state` 'initialized' | 'pendingSignature' | 'eddsaPendingCommitment' | 'eddsaPendingRShare' | 'eddsaPendingGShare' | 'ecdsaMPCv2Round1' | 'ecdsaMPCv2Round2' | 'ecdsaMPCv2Round3' | 'eddsaMPCv2Round1' | 'eddsaMPCv2Round2' | 'eddsaMPCv2Round3' | 'readyToCombineShares' | 'signed' | 'held' | 'delivered' | 'invalidSignature' | 'rejected', required — If supplied, only transaction request transaction state changes from the provided list will trigger notifications. If not provided, all transaction request transaction state changes will trigger notifications. - `messageRaw` string, required — The raw message to be signed - `signatureShares` object[] - `vssProof` string — The VSS proof of the signature share - `privateShareProof` string — The private share proof - `publicShare` string — The public share - `from` 'user' | 'backup' | 'bitgo', required - `to` 'user' | 'backup' | 'bitgo', required - `share` string, required — The signature share - `privateSignatureShares` object[] - `vssProof` string — The VSS proof of the signature share - `privateShareProof` string — The private share proof - `publicShare` string — The public share - `from` 'user' | 'backup' | 'bitgo', required - `to` 'user' | 'backup' | 'bitgo', required - `share` string, required — The signature share - `commitmentShares` object[] - `type` 'commitment', required — The type of the commitment share - `from` 'user' | 'backup' | 'bitgo', required - `to` 'user' | 'backup' | 'bitgo', required - `share` string, required — The commitment share. - `encryptedShares` object[] - `type` 'encryptedSignerShare' | 'encryptedRShare', required - `from` 'user' | 'backup' | 'bitgo', required - `to` 'user' | 'backup' | 'bitgo', required - `share` string, required — The commitment share. - `txHash` string — Transaction hash - `updatedDate` string, date-time — Date when the message was last updated - `createdDate` string, date-time — Date when the message was created - `messageEncoded` string — The encoded message - `messageBroadcastable` string — The broadcastable message - `messageStandardType` string — The encoded message - `derivationPath` string — Derivation path for the message - `combineSigShare` string — Combined signature share - `coin` string — Coin type for the message - `bitgoPaillierChallenge` unknown - `encryptedChallenge` string — BitGo's encrypted challenge for ECDSA with Range Proofs - `apiVersion` 'lite' | 'full' — The API version of the transaction request - `txRequestId` string, uuid, required - `idempotencyKey` string — The idempotency key of the transaction request - `walletId` string, required - `walletType` 'backing' | 'cold' | 'custodial' | 'custodialPaired' | 'hot' | 'advanced' | 'trading' — The type describes who owns the keys to the wallet associated to the TxRequest. - `version` number, required — The version of the transaction request - `enterpriseId` string — If the wallet that owns the TxRequest is owned by an enterprise then this is the Id of said enterprise. - `organizationId` string — The id of the organization the TxRequest's wallet belongs to. - `state` 'pendingApproval' | 'canceled' | 'rejected' | 'initialized' | 'pendingDelivery' | 'delivered' | 'pendingUserSignature' | 'pendingUserCommitment' | 'pendingUserRShare' | 'pendingUserGShare' | 'readyToSend' | 'signed' | 'failed', required - `date` string, date-time, required — The date and time this version of the TxRequest document was created. - `createdDate` string, date-time, required — The date and time the version 1 TxRequest document was created. - `userId` string, required — The Id of the User that produced this version of the TxRequest document. Could have created a new document or updated an existing document. - `initiatedBy` string, required — The Id of the User that originally created the TxRequest document (initiated the TxRequest). - `updatedBy` string, required — The Id of the User that last updated the TxRequest document. This is an alias for the userId field. - `intent` unknown - `intents` unknown[], required - unknown - `pendingApprovalId` string — The id of the Pending Approval that was created for the TxRequest if one was required. - `policiesChecked` boolean - `latest` boolean, required — Indicates if this is the latest transaction request - `isCanceled` boolean — True, if the transaction request is canceled. - `cancelReason` string — The reason the transaction request was canceled, if applicable. - `initiatedByDAppClient` boolean — True when the txRequest was initiated by a dApp OAuth client (e.g. Narval). - `txChannel` object — Immutable DeFi / marketplace channel classification (DEFI-300). - `clientId` string — OAuth dApp client id (Narval). - `connector` 'narval' | 'walletconnect' — External entry connector (narval, walletconnect). Omitted for internal BitGo flows. - `defiAction` 'approve' | 'deposit' | 'withdraw' - `protocol` 'morpho' | 'aave' | 'concrete' — DeFi protocol (morpho, aave, concrete). - `source` 'internal' | 'external', required - `type` 'defi', required - `vaultId` string - `walletConnectRequestId` string — defi-service walletconnect_requests.id when supplied on the intent. - `bitgoRangeProofChallenge` object - `ntildeProof` NtildeProof, required — The ntildeProof value is only required when creating the initial config. - `h1WrtH2` object, required - `alpha` string[], required - `t` string[], required - `h2WrtH1` object, required - `alpha` string[], required - `t` string[], required - `ntilde` string, required — Range proof challenge value - `h1` string, required — Range proof challenge value - `h2` string, required — Range proof challenge value - `totalCount` number - `nextBatchPrevId` string, uuid — When a result set is truncated, this field returns the id of the last object in the previous batch. To get the next batch of results, pass this value via the "prevId" query parameter. ## Other responses - `400` — Bad Request - `401` — Unauthorized - `403` — Forbidden - `404` — Not Found --- [API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)