> ## Documentation Index > Fetch the complete documentation index at: https://cobo.com/products/agentic-wallet/manual/llms.txt > Use this file to discover all available pages before exploring further. # Get transaction record by request id > This operation retrieves a transaction record using the client-supplied idempotency key (`request_id`) scoped to the given wallet. ## OpenAPI ````yaml get /api/v1/wallets/{wallet_uuid}/transactions/by-request-id/{request_id} openapi: 3.1.0 info: title: Cobo Agentic Wallet Service description: Unified wallet engine for human and agent principals version: 1.3.0 servers: [] security: [] paths: /api/v1/wallets/{wallet_uuid}/transactions/by-request-id/{request_id}: get: tags: - Transaction Records summary: Get transaction record by request id description: >- This operation retrieves a transaction record using the client-supplied idempotency key (`request_id`) scoped to the given wallet. operationId: get_user_transaction_by_request_id parameters: - name: wallet_uuid in: path required: true schema: type: string format: uuid description: The UUID of the wallet that owns the transaction. title: Wallet Uuid description: The UUID of the wallet that owns the transaction. - name: request_id in: path required: true schema: type: string minLength: 1 maxLength: 255 description: >- The same `request_id` passed when submitting the transfer or contract call. title: Request Id description: >- The same `request_id` passed when submitting the transfer or contract call. - name: ext in: query required: false schema: type: boolean description: >- When `true`, the response includes an `ext_transactions` list with associated downstream transactions. default: false title: Ext description: >- When `true`, the response includes an `ext_transactions` list with associated downstream transactions. - name: X-API-Key in: header required: false schema: title: X-Api-Key type: string nullable: true responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/StandardResponse_UserTransactionRead_' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/WrappedValidationError' components: schemas: StandardResponse_UserTransactionRead_: properties: success: type: boolean title: Success default: true result: $ref: '#/components/schemas/UserTransactionRead' suggestion: type: string title: Suggestion default: '' message: type: string title: Message default: '' meta: $ref: '#/components/schemas/PaginationMeta' nullable: true type: object required: - result title: StandardResponse[UserTransactionRead] WrappedValidationError: title: WrappedValidationError type: object required: - success - error properties: success: type: boolean const: false default: false title: Success error: type: object title: Error required: - detail properties: detail: type: array title: Detail items: $ref: '#/components/schemas/ValidationError' UserTransactionRead: properties: id: type: string format: uuid title: Id description: The transaction record ID. wallet_id: type: string format: uuid title: Wallet Id description: The wallet ID this transaction belongs to. pact_id: title: Pact Id description: >- When the originating request used a pact-scoped API key, the pact UUID (mirrors `data.pact_id` when set). type: string format: uuid nullable: true type: $ref: '#/components/schemas/UserTransactionOperationType' description: >- The operation type. Possible values: `transfer`, `contract_call`, `message_sign`, `deposit`. request_type: $ref: '#/components/schemas/UserTransactionRequestType' description: >- The originating request type. Possible values: `transfer`, `contract_call`, `deposit`, `message_sign`, `x402_payment`, `mpp_payment`. When multiple request_types share the same operation type (e.g. x402_payment → transfer), this field distinguishes the source. nullable: true chain_id: type: string title: Chain Id description: >- The Cobo chain ID for this transaction (for example, `SETH`, `BASE_ETH`, `SOL`). token_id: type: string title: Token Id description: >- The Cobo token ID for this transaction (for example, `SETH`, `SETH_USDC`). src_address: type: string title: Src Address description: The source on-chain address. dst_address: type: string title: Dst Address description: The destination on-chain address. amount: type: string title: Amount description: The transaction amount as a decimal string. status: type: integer title: Status description: The transaction status code. status_display: type: string title: Status Display description: >- The human-readable transaction status (for example, `success`, `failed`, `broadcasting`). default: '' sub_status: title: Sub Status description: >- The fine-grained transaction sub-status (for example, `broadcasting`, `pendingscreening`). Mirrors `UserTransaction.sub_status`. type: string nullable: true transaction_hash: title: Transaction Hash description: The on-chain transaction hash, if available. type: string nullable: true request_id: title: Request Id description: The client-supplied request identifier, if set. type: string nullable: true description: title: Description description: >- Optional note from submission; duplicated from `data.description` when present. type: string nullable: true fee: title: Fee description: >- Fee information reported by the downstream provider. Contains both the configured fee parameters (e.g. `max_fee_per_gas`, `gas_limit`) and the actual execution results (e.g. `fee_used`, `gas_used`, `effective_gas_price`). Populated after the provider processes the transaction. additionalProperties: true type: object nullable: true cobo_transaction_id: title: Cobo Transaction Id description: >- The downstream provider's transaction ID. Populated when the transaction is submitted to and acknowledged by the provider. type: string nullable: true data: $ref: '#/components/schemas/UserTransactionData' description: Additional transaction metadata. created_at: type: string format: date-time title: Created At description: The timestamp when this record was created, in ISO 8601 format. updated_at: type: string format: date-time title: Updated At description: The timestamp when this record was last updated, in ISO 8601 format. ext_transactions: title: Ext Transactions description: >- Associated external (downstream) transactions. Only populated when the request includes `ext=true`. items: $ref: '#/components/schemas/ExternalTransactionRead' type: array nullable: true type: object required: - id - wallet_id - type - chain_id - token_id - src_address - dst_address - amount - status - transaction_hash - data - created_at - updated_at title: UserTransactionRead description: Public representation of a user transaction. PaginationMeta: properties: total: title: Total type: integer nullable: true offset: title: Offset type: integer nullable: true limit: title: Limit type: integer nullable: true has_more: title: Has More type: boolean nullable: true after: title: After type: string nullable: true before: title: Before type: string nullable: true type: object title: PaginationMeta description: |- Pagination metadata for list responses. Supports both legacy offset-based and cursor-based pagination. Cursor fields (``has_more``, ``after``, ``before``) are populated for cursor-paginated endpoints. Legacy fields (``offset``, ``limit``) are populated when the caller uses the deprecated ``offset`` parameter. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError UserTransactionOperationType: type: string enum: - transfer - contract_call - message_sign - deposit title: UserTransactionOperationType UserTransactionRequestType: type: string enum: - transfer - contract_call - deposit - message_sign - x402_payment - mpp_payment title: UserTransactionRequestType UserTransactionData: properties: sub_type: title: Sub Type type: string nullable: true contract_addr: title: Contract Addr type: string nullable: true value: title: Value type: string nullable: true calldata: title: Calldata type: string nullable: true instructions: title: Instructions items: additionalProperties: true type: object type: array nullable: true fee: title: Fee additionalProperties: true type: object nullable: true cobo_transaction_id: title: Cobo Transaction Id type: string nullable: true failed_reason: title: Failed Reason type: string nullable: true description: title: Description type: string nullable: true signature: title: Signature type: string nullable: true destination_type: title: Destination Type type: string nullable: true eip712_typed_data: title: Eip712 Typed Data additionalProperties: true type: object nullable: true payment_required_raw: title: Payment Required Raw type: string nullable: true payment_signature_raw: title: Payment Signature Raw type: string nullable: true siwx_header_value: title: Siwx Header Value type: string nullable: true mpp_authorization_header: title: Mpp Authorization Header type: string nullable: true pact_id: title: Pact Id type: string nullable: true type: object title: UserTransactionData description: >- Structured extra data stored in the JSON ``data`` column. All fields are optional so the same schema covers transfer, contract_call, deposit, and x402 payment records. ExternalTransactionRead: properties: id: type: string format: uuid title: Id description: The external transaction UUID. user_transaction_uuid: type: string format: uuid title: User Transaction Uuid description: The parent UserTransaction UUID. operation_type: $ref: '#/components/schemas/ExternalTransactionOperationType' description: >- The operation the ET performs. Possible values: `transfer`, `contract_call`, `message_sign`, `deposit`. stage: $ref: '#/components/schemas/ExternalTransactionStage' description: >- Stage within the UT lifecycle. Possible values: `original`, `sign`, `broadcast`, `drop`, `speedup`, `delegation`, `userop`, `provider_userop`. nullable: true provider: $ref: '#/components/schemas/TransactionProvider' description: >- Downstream provider that executes this ET. Possible values: `waas`, `alchemy`, `pimlico`, `node_rpc`. nullable: true external_id: title: External Id description: Provider-assigned transaction ID (e.g. WaaS cobo_tx_id). type: string nullable: true caw_request_id: title: Caw Request Id description: CAW-side idempotency key sent to the provider. type: string nullable: true status: type: string title: Status description: Downstream status string (provider-specific). transaction_hash: title: Transaction Hash description: On-chain transaction hash, if available. type: string nullable: true data: additionalProperties: true type: object title: Data description: Additional downstream metadata. created_at: type: string format: date-time title: Created At description: Creation timestamp. updated_at: type: string format: date-time title: Updated At description: Last-updated timestamp. type: object required: - id - user_transaction_uuid - operation_type - status - created_at - updated_at title: ExternalTransactionRead description: >- Public representation of an ExternalTransaction (Layer 3 downstream operation). ExternalTransactionOperationType: type: string enum: - transfer - contract_call - message_sign - deposit title: ExternalTransactionOperationType ExternalTransactionStage: type: string enum: - original - sign - broadcast - drop - speedup - delegation - userop - provider_userop title: ExternalTransactionStage TransactionProvider: type: string enum: - waas - alchemy - pimlico - node_rpc - caw title: TransactionProvider ````