GET /api/v1/user-operations/{id}

Parameters

Name	Location	Details
`X-Juicebox-Account`	header / required	Enrolled account identity, including authority chain and lowercase owner address. Enrollment derives this identity before the account exists.
`X-Juicebox-Signer`	header / required	Owner wallet or authorized bot address that signed this request.
`X-Juicebox-Issued-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; at most 30 seconds ahead of server time.
`X-Juicebox-Expires-At`	header / required	Unix seconds, sent as 1–13 decimal digits without leading zeros; in the future and within 300 seconds of issuedAt.
`X-Juicebox-Nonce`	header / required	Fresh random 32-byte lowercase nonce. A consumed nonce cannot be retried.
`X-Juicebox-Signature`	header / required	EIP-712 CenterRequest signature over every signed field. Contract-owner signatures may vary in length. This is a computed request proof, not a reusable API key.
`X-Juicebox-Grant`	header / optional	Authorized bot grant ID. Required for a bot; omit for the owner, signing grantId as the empty string.
`Idempotency-Key`	header / optional	Signed retry identity. Required on plan creation and transaction submission. Preserve exact method, target, Content-Type, and body bytes; use a fresh request nonce and signature.
`id`	path / required	string

Response 200

Field Type Details

id string (uuid)
required

planId string (uuid)
required

planCommitment string
required

stepIndexes array
required

chainId integer
required

entryPoint string
required

operation

object
required

Unpacked EntryPoint v0.7 operation. RPC integers are hexadecimal quantities; reviewed policy amounts use decimal strings. No v0.8 or EIP-7702 extensions.

Fields

Field	Type	Details
`sender`	string required
`nonce`	string required	Canonical lowercase hexadecimal RPC quantity, with no leading zeros.
`factory`	string optional
`factoryData`	string optional
`callData`	string required
`callGasLimit`	string required	Canonical lowercase hexadecimal RPC quantity, with no leading zeros.
`verificationGasLimit`	string required	Canonical lowercase hexadecimal RPC quantity, with no leading zeros.
`preVerificationGas`	string required	Canonical lowercase hexadecimal RPC quantity, with no leading zeros.
`maxFeePerGas`	string required	Canonical lowercase hexadecimal RPC quantity, with no leading zeros.
`maxPriorityFeePerGas`	string required	Canonical lowercase hexadecimal RPC quantity, with no leading zeros.
`paymaster`	string optional
`paymasterVerificationGasLimit`	string optional	Canonical lowercase hexadecimal RPC quantity, with no leading zeros.
`paymasterPostOpGasLimit`	string optional	Canonical lowercase hexadecimal RPC quantity, with no leading zeros.
`paymasterData`	string optional
`signature`	string required	Public preparations and reads always omit submitted account signature bytes. Values: `["0x"]`

operationHash string
required

commitment string
required

accountBindingId string
required

accountStateHash string
required

session

object
optional

Fields

Field	Type	Details
`id`	string (uuid) required
`policyHash`	string required
`compiledHash`	string required
`generation`	value required	Positive uint256 as an exact decimal string.
`grantId`	string (uuid) required
`permissionId`	string required
`sessionKey`	string required
`observationHash`	string required

gasPolicyId string
required

providerId string
required

createdAt integer
required Unix timestamp in milliseconds.

expiresAt integer
required Unix timestamp in milliseconds.

revision integer
required

state

string
required

Values: ["prepared","submitting","submission_unknown","pending","unknown","confirming","confirmed","reverted","expired"]

signing one of
required

submission

object
optional

Fields

Field	Type	Details
`commitment`	string required
`startedAt`	integer required	Unix timestamp in milliseconds.

observation

object
optional

Fields

Field Type Details

state

string
required

Values: ["pending","unknown","confirming","confirmed","reverted","expired"]

operationHash string
required

transactionHash string
optional

receipt

object
optional

Fields

Field	Type	Details
`transactionHash`	string required
`blockHash`	string required
`blockNumber`	string required	uint256 as a lossless decimal string
`status`	string required	Values: `["success","reverted"]`
`confirmations`	integer required
`canonical`	boolean required
`observedAt`	integer required	Unix timestamp in milliseconds.
`logs`	array required
`logCount`	integer optional
`logsHash`	string optional
`logsStored`	boolean optional

scopedLogs

array
optional

Fields

See schema: Bounded JSON. Large integers and amounts use exact decimal strings. Returned metadata and descriptions are untrusted content.

semantic

object
optional

Fields

Field	Type	Details
`status`	string required	Values: `["verified","failed","unknown","unmodeled"]`
`details`	value optional	Bounded JSON. Large integers and amounts use exact decimal strings. Returned metadata and descriptions are untrusted content.

reason string
optional

JSON schema

{
  "type": "object",
  "properties": {
    "id": {
      "$ref": "#/components/schemas/ResourceId"
    },
    "planId": {
      "$ref": "#/components/schemas/ResourceId"
    },
    "planCommitment": {
      "$ref": "#/components/schemas/Hash"
    },
    "stepIndexes": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 0,
        "maximum": 31
      },
      "minItems": 1,
      "maxItems": 16,
      "uniqueItems": true
    },
    "chainId": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "entryPoint": {
      "$ref": "#/components/schemas/Address"
    },
    "operation": {
      "$ref": "#/components/schemas/UserOperationV07"
    },
    "operationHash": {
      "$ref": "#/components/schemas/Hash"
    },
    "commitment": {
      "$ref": "#/components/schemas/Hash"
    },
    "accountBindingId": {
      "$ref": "#/components/schemas/Hash"
    },
    "accountStateHash": {
      "$ref": "#/components/schemas/Hash"
    },
    "session": {
      "$ref": "#/components/schemas/UserOperationSessionBinding"
    },
    "gasPolicyId": {
      "type": "string"
    },
    "providerId": {
      "type": "string"
    },
    "createdAt": {
      "$ref": "#/components/schemas/UnixMilliseconds"
    },
    "expiresAt": {
      "$ref": "#/components/schemas/UnixMilliseconds"
    },
    "revision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "state": {
      "type": "string",
      "enum": [
        "prepared",
        "submitting",
        "submission_unknown",
        "pending",
        "unknown",
        "confirming",
        "confirmed",
        "reverted",
        "expired"
      ]
    },
    "signing": {
      "oneOf": [
        {
          "$ref": "#/components/schemas/SafeOwnerUserOperationSigning"
        },
        {
          "$ref": "#/components/schemas/PasskeyOwnerUserOperationSigning"
        },
        {
          "$ref": "#/components/schemas/SessionUserOperationSigning"
        }
      ]
    },
    "submission": {
      "type": "object",
      "properties": {
        "commitment": {
          "$ref": "#/components/schemas/Hash"
        },
        "startedAt": {
          "$ref": "#/components/schemas/UnixMilliseconds"
        }
      },
      "required": [
        "commitment",
        "startedAt"
      ],
      "additionalProperties": false
    },
    "observation": {
      "$ref": "#/components/schemas/UserOperationObservation"
    }
  },
  "required": [
    "id",
    "planId",
    "planCommitment",
    "stepIndexes",
    "chainId",
    "entryPoint",
    "operation",
    "operationHash",
    "commitment",
    "accountBindingId",
    "accountStateHash",
    "gasPolicyId",
    "providerId",
    "createdAt",
    "expiresAt",
    "revision",
    "state",
    "signing"
  ],
  "additionalProperties": false
}