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
}
}
}