Skip to main content
GET
/
v1
/
w3s
/
buidl
/
userOps
List user operations
curl --request GET \
  --url https://api.circle.com/v1/w3s/buidl/userOps \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "userOperations": [
      {
        "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
        "blockchain": "MATIC-AMOY",
        "state": "COMPLETE",
        "userOpHash": "0x54d3cccda6ffa503bc1e554937fe67818b6ca1a5a05c7e66ebfa32bf27520152",
        "userOperation": {
          "callData": "<string>",
          "nonce": "<string>",
          "sender": "<string>",
          "callGasLimit": "<string>",
          "factory": "<string>",
          "factoryData": "<string>",
          "initCode": "<string>",
          "maxFeePerGas": "<string>",
          "maxPriorityFeePerGas": "<string>",
          "paymaster": "<string>",
          "paymasterAndData": "<string>",
          "paymasterData": "<string>",
          "paymasterPostOpGasLimit": "<string>",
          "paymasterVerificationGasLimit": "<string>",
          "preVerificationGas": "<string>",
          "signature": "<string>",
          "verificationGasLimit": "<string>"
        },
        "refId": "custom_ref_id",
        "actualGasCost": "0.0015584763706281",
        "actualGasUsed": "182385",
        "blockDate": "2023-01-01T12:04:05Z",
        "blockHash": "0x2eb19fd02850ff963efefbaa71dbcd4acb41a9c261c4f8961979db1b56d48704",
        "blockHeight": 123456,
        "errorReason": "FAILED_REPLACED",
        "revertReason": "<string>",
        "to": "0x4b6c0b0078b63f881503e7fd3a9a1061065db242",
        "txHash": "0x4a25cc5e661d8504b59c5f38ba93f010e8518966f00e2ceda7955c4b8621357d",
        "createDate": "2023-01-01T12:04:05Z",
        "updateDate": "2023-01-01T12:04:05Z"
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Circle's API Keys are formatted in the following structure "PREFIX:ID:SECRET". All three parts are requred to make a successful request.

Query Parameters

​
blockchain
enum<string>

Filter by the blockchain. Blockchain network of resource.

Available options:
ETH,
ETH-SEPOLIA,
MATIC,
MATIC-AMOY,
ARB,
ARB-SEPOLIA,
UNI,
UNI-SEPOLIA,
BASE,
BASE-SEPOLIA,
OP,
OP-SEPOLIA
Example:

"MATIC-AMOY"

​
refId
string

Filter by the optional user-defined reference identifier. Reference or description used to identify the object.

Example:

"custom_ref_id"

​
senders
string

Filter by the senders. A list of blockchain generated unique identifier, associated with wallet (account), smart contract or other blockchain objects, seperated by comma.

Example:

"0x4b6c0b0078b63f881503e7fd3a9a1061065db242,0x187785007d4a7D6756e834768597dA8fA6fcfE8a"

​
state
enum<string>

Filter by the state. State of user operation.

Available options:
SENT,
CONFIRMED,
COMPLETE,
FAILED
Example:

"COMPLETE"

​
txHash
string

Filter by the txHash. Blockchain generated identifier of transaction.

Example:

"0x4a25cc5e661d8504b59c5f38ba93f010e8518966f00e2ceda7955c4b8621357d"

​
userOpHash
string

Filter by the userOpHash. Generated identifier of user operation.

Example:

"0x54d3cccda6ffa503bc1e554937fe67818b6ca1a5a05c7e66ebfa32bf27520152"

​
from
string<date-time>

Queries items created since the specified date-time (inclusive) in ISO 8601 format.

Example:

"2023-01-01T12:04:05Z"

​
to
string<date-time>

Queries items created before the specified date-time (inclusive) in ISO 8601 format.

Example:

"2023-01-01T12:04:05Z"

​
pageBefore
string<uuid>

A collection ID value used for pagination.

It marks the exclusive end of a page. When provided, the collection resource will return the next n items before the id, with n being specified by pageSize.

The items will be returned in the natural order of the collection.

The resource will return the first page if neither pageAfter nor pageBefore are specified.

SHOULD NOT be used in conjunction with pageAfter.

​
pageAfter
string<uuid>

A collection ID value used for pagination.

It marks the exclusive begin of a page. When provided, the collection resource will return the next n items after the id, with n being specified by pageSize.

The items will be returned in the natural order of the collection.

The resource will return the first page if neither pageAfter nor pageBefore are specified.

SHOULD NOT be used in conjunction with pageBefore.

​
pageSize
integer
default:10

Limits the number of items to be returned.

Some collections have a strict upper bound that will disregard this value. In case the specified value is higher than the allowed limit, the collection limit will be used.

If avoided, the collection will determine the page size itself.

Required range: 1 <= x <= 50

Response

User operation list retrieved

​
data
object
required