Get User Operations by Owner

Overview

This API endpoint allows you to retrieve a list of user operations associated with a specific owner.

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

Path Parameters

ownerId (required): The unique identifier of the owner.

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}}/v1/userOp/owner/6831d4f51579da4b44991558?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:
- data (array): Array of user operations
  - 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.
  - appId (string): Your application ID.
  - 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.
- pagination (object): Pagination information
  - total (number): Total number of records.
  - page (number): Current page number.
  - limit (number): Number of records per page.
  - totalPages (number): Total number of pages.
  - hasNext (boolean): Whether there is a next page.
  - hasPrev (boolean): Whether there is a previous page.

Example Response

{
    "status": 200,
    "message": "success",
    "data": {
        "data": [
            {
                "id": "6832c8a398edc14f4928b5fa",
                "createdAt": "2025-05-25T07:37:07.373Z",
                "updatedAt": "2025-05-25T07:37:20.96Z",
                "accountId": "6831d4f51579da4b4499155a",
                "ownerId": "6831d4f51579da4b44991558",
                "clientId": "ca1f7181-d647-42c5-bd4b-aa50706d227b",
                "appId": "8bff7124-2b2e-491d-9baa-cce89bd196af",
                "signature": "***",
                "userOpHash": "***",
                "status": "failed",
                "type": "send_coin",
                "network": "ethereum-holesky",
                "chainId": 17000,
                "payer": "organization",
                "validUntil": "2025-05-25T08:07:07.373Z",
                "failedReason": "sending user operation failed: UserOperation reverted with reason: AA24 signature error",
                "bundlerVersion": "0.7",
                "successAt": null,
                "failedAt": "2025-05-25T07:37:20.987Z",
                "sentAt": null
            },
            {
                "id": "6832c79298edc14f4928b5f8",
                "createdAt": "2025-05-25T07:32:34.132Z",
                "updatedAt": "2025-05-25T07:33:44.8Z",
                "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-25T08:02:34.132Z",
                "failedReason": null,
                "bundlerVersion": "0.7",
                "successAt": "2025-05-25T07:33:44.8Z",
                "failedAt": null,
                "sentAt": "2025-05-25T07:33:10.889Z"
            }
        ],
        "pagination": {
            "total": 6,
            "page": 1,
            "limit": 10,
            "totalPages": 1,
            "hasNext": false,
            "hasPrev": false
        }
    }
}

Get User Operation List Submit User Operation