Account Abstraction
API Reference
User Operation
Get User Operation List

Get User Operations

Overview

This API endpoint allows you to retrieve a list of user operations from all owners associated with your app.

  • HTTP Method: GET
  • Endpoint: {{BASE_URL}}/api/v1/userOp

Query Parameters

  • limit (optional): Number of records to return per page. Default is 10.
  • page (optional): Page number for pagination. Default is 1.

Request

Request Headers

  • X-APP-ID: (required): APP ID/Project ID obtained from dashboard.
  • X-SIGNATURE: (required): Calculated signature, please refer to Authorization section.
  • X-TIMESTAMP: (required): Request timestamp in RFC3339 format.

Example Request Syntax

curl -X GET \
-H "x-app-id: $YOUR_APP_ID" \
-H "x-signature: $CALCULATED_SIGNATURE" \
-H "x-timestamp: $TIMESTAMP" \
"{{BASE_URL}}/api/v1/userOp?limit=10&page=1"

Response

The response will include a JSON object with the following properties:

  • status (number): The HTTP status code of the response (e.g., 200 for success).
  • message (string): A message providing additional information about the operation.
  • data (object): An object containing the operation details:
    • id (string): Unique identifier for the user operation.
    • createdAt (string): Timestamp when the operation was created.
    • updatedAt (string): Timestamp when the operation was last updated.
    • accountId (string): ID of the account associated with the operation.
    • ownerId (string): ID of the owner of the account.
    • clientId (string): Client ID associated with the operation.
    • signature (string): Operation signature.
    • userOpHash (string): Hash of the user operation.
    • status (string): Current status of the operation (e.g., "on_process").
    • type (string): Type of operation (e.g., "send_token").
    • network (string): Network where the operation was executed.
    • chainId (number): Chain ID of the network.
    • payer (string): Who pays for the operation (owner, organization, none).
    • validUntil (string): Timestamp until when the operation is valid.
    • failedReason (string|null): Reason for failure if the operation failed.
    • bundlerVersion (string): Version of the bundler used.
    • successAt (string|null): Timestamp when the operation succeeded.
    • failedAt (string|null): Timestamp when the operation failed.
    • sentAt (string): Timestamp when the operation was sent.

Example Response

{
    "status": 200,
    "message": "success",
    "data": {
        "data": [
            {
                "id": "6831d81ad3da75713be9a163",
                "createdAt": "2025-05-24T14:30:50.981Z",
                "updatedAt": "2025-05-24T14:31:52.611Z",
                "accountId": "6831d4f51579da4b4499155a",
                "ownerId": "6831d4f51579da4b44991558",
                "clientId": "ca1f7181-d647-42c5-bd4b-aa50706d227b",
                "appId": "8bff7124-2b2e-491d-9baa-cce89bd196af",
                "signature": "***",
                "userOpHash": "***",
                "status": "success",
                "type": "send_coin",
                "network": "ethereum-holesky",
                "chainId": 17000,
                "payer": "organization",
                "validUntil": "2025-05-24T15:00:50.981Z",
                "failedReason": null,
                "bundlerVersion": "0.7",
                "successAt": "2025-05-24T14:31:52.611Z",
                "failedAt": null,
                "sentAt": "2025-05-24T14:31:29.609Z",
                "clientGasTankUsageHistory": {
                    "id": "6831d841d3da75713be9a164",
                    "clientId": "ca1f7181-d647-42c5-bd4b-aa50706d227b",
                    "appId": "8bff7124-2b2e-491d-9baa-cce89bd196af",
                    "clientGasTankId": "6811cd8b34edd3d103babadc",
                    "userOpId": "6831d81ad3da75713be9a163",
                    "nativeToGasTankRate": 2552.51,
                    "amountInNative": "134463957427",
                    "amountInGasTank": "343220595971991",
                    "initialDeductedAmountInNative": "274813276089",
                    "initialDeductedAmountInGasTank": "701463635349933",
                    "refundedAmountInNative": "140349318662",
                    "refundedAmountInGasTank": "358243039377942",
                    "clientFeeInGasTank": "0",
                    "createdAt": "2025-05-24T14:31:29.479Z",
                    "refundedAt": "2025-05-24T14:31:52.614Z"
                }
            },
            {
                "id": "6831d64e1579da4b4499155e",
                "createdAt": "2025-05-24T14:23:10.209Z",
                "updatedAt": "2025-05-24T14:23:57.12Z",
                "accountId": "6831d4f51579da4b4499155a",
                "ownerId": "6831d4f51579da4b44991558",
                "clientId": "ca1f7181-d647-42c5-bd4b-aa50706d227b",
                "appId": "8bff7124-2b2e-491d-9baa-cce89bd196af",
                "signature": "***",
                "userOpHash": "***",
                "status": "success",
                "type": "send_coin",
                "network": "ethereum-holesky",
                "chainId": 17000,
                "payer": "organization",
                "validUntil": "2025-05-24T14:53:10.209Z",
                "failedReason": null,
                "bundlerVersion": "0.7",
                "successAt": "2025-05-24T14:23:57.12Z",
                "failedAt": null,
                "sentAt": "2025-05-24T14:23:34.437Z",
                "clientGasTankUsageHistory": {
                    "id": "6831d6661579da4b4499155f",
                    "clientId": "ca1f7181-d647-42c5-bd4b-aa50706d227b",
                    "appId": "8bff7124-2b2e-491d-9baa-cce89bd196af",
                    "clientGasTankId": "6811cd8b34edd3d103babadc",
                    "userOpId": "6831d64e1579da4b4499155e",
                    "nativeToGasTankRate": 2550.52,
                    "amountInNative": "134496335684",
                    "amountInGasTank": "343035594088755",
                    "initialDeductedAmountInNative": "274914493462",
                    "initialDeductedAmountInGasTank": "701174913864700",
                    "refundedAmountInNative": "140418157778",
                    "refundedAmountInGasTank": "358139319775945",
                    "clientFeeInGasTank": "0",
                    "createdAt": "2025-05-24T14:23:34.31Z",
                    "refundedAt": "2025-05-24T14:23:57.122Z"
                }
            }
        ],
        "pagination": {
            "total": 5,
            "page": 1,
            "limit": 10,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}