API Reference

Web3 Services

API Overview

Health

Webhook Subscriptions

Configurations

Monitor Tokens

Developer Account

Faucet

Developer-Controlled Wallets

Wallet Sets

Wallets

Signing

Transactions

Token Lookup

Circle Contracts

Templates

View / Update

Interact

Deploy / Import

Event Monitors

Modular Wallets

Transfers

UserOps

Wallets

User-Controlled Wallets

Social/ Email Authentication

PIN Authentication

Users

Wallets

Transactions

Token Lookup

Signing

Compliance Engine

Address Screening

Retrieve a user operation

gethttps://api.circle.com/v1/w3s/buidl/userOps/{id}

Reference
Playground

Retrieve an existing user operation.

Header parameters

X-Request-Id

string

Developer-provided parameter used to identify this request. Useful when communicating with Circle Support.

Path parameters

uuid

Required

The universally unique identifier of the resource.

Response

200UserOpResponse

Response Body

object

data

object

Required

Show 1 properties

userOperation

object

Required

Show 17 properties

string

Required

System-generated unique identifier of the resource.

refId

string

Reference or description used to identify the object.

actualGasCost

string

Actual gas cost of user operation.

actualGasUsed

string

Actual gas used of user operation.

blockDate

string

Date and time of block, in ISO-8601 UTC format.

blockHash

string

Blockchain generated identifier of block.

blockHeight

integer

Blockchain height of block.

blockchain

string

Required

Blockchain network of resource.

Allowed valuesETHETH-SEPOLIAMATICMATIC-AMOYARBARB-SEPOLIAUNIUNI-SEPOLIABASEBASE-SEPOLIAOPOP-SEPOLIA

errorReason

string

Error reason of failed user operation.

Allowed valuesFAILED_ON_CHAINFAILED_REPLACED

revertReason

string

On-chain failed revert reason of user operation.

state

string

Required

State of user operation.

Allowed valuesSENTCONFIRMEDCOMPLETEFAILED

string

Address of user operation executed with.

txHash

string

Blockchain generated identifier of transaction.

userOpHash

string

Required

Generated identifier of user operation.

userOperation

object

Required

Show 17 properties

callData

string

Required

callGasLimit

string

factory

string

factoryData

string

initCode

string

maxFeePerGas

string

maxPriorityFeePerGas

string

nonce

string

Required

paymaster

string

paymasterAndData

string

paymasterData

string

paymasterPostOpGasLimit

string

paymasterVerificationGasLimit

string

preVerificationGas

string

sender

string

Required

signature

string

verificationGasLimit

string

createDate

string

Date and time the resource was created, in ISO-8601 UTC format.

updateDate

string

Date and time the resource was last updated, in ISO-8601 UTC format.

400Error

401NotAuthorizedResponse

RequestChoose a language

ResponseChoose an example

1{
2  "data": {
3    "userOperation": {
4      "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
5      "refId": "custom_ref_id",
6      "actualGasCost": "0.0015584763706281",
7      "actualGasUsed": "182385",
8      "blockDate": "2023-01-01T12:04:05Z",
9      "blockHash": "0x2eb19fd02850ff963efefbaa71dbcd4acb41a9c261c4f8961979db1b56d48704",
10      "blockHeight": 123456,
11      "blockchain": "MATIC-AMOY",
12      "errorReason": "FAILED_REPLACED",
13      "revertReason": "",
14      "state": "COMPLETE",
15      "to": "0x4b6c0b0078b63f881503e7fd3a9a1061065db242",
16      "txHash": "0x4a25cc5e661d8504b59c5f38ba93f010e8518966f00e2ceda7955c4b8621357d",
17      "userOpHash": "0x54d3cccda6ffa503bc1e554937fe67818b6ca1a5a05c7e66ebfa32bf27520152",
18      "userOperation": {
19        "callData": "",
20        "callGasLimit": "",
21        "factory": "",
22        "factoryData": "",
23        "initCode": "",
24        "maxFeePerGas": "",
25        "maxPriorityFeePerGas": "",
26        "nonce": "",
27        "paymaster": "",
28        "paymasterAndData": "",
29        "paymasterData": "",
30        "paymasterPostOpGasLimit": "",
31        "paymasterVerificationGasLimit": "",
32        "preVerificationGas": "",
33        "sender": "",
34        "signature": "",
35        "verificationGasLimit": ""
36      },
37      "createDate": "2023-01-01T12:04:05Z",
38      "updateDate": "2023-01-01T12:04:05Z"
39    }
40  }
41}

Did this page help you?

Developer Terms Service Terms Privacy Policy Acceptable Use Your Privacy Choices

Cookie Policy