4337

get

Returns a SafeOperation given its Safe operation hash

Authorizations

cookieAuthtokenAuth

sessionidstringOptional

Path parameters

safe_operation_hashstringRequired

Responses

200Success

application/json

createdstring · date-timeRequired

modifiedstring · date-timeRequired

safeOperationHashstringRequired

validAfterstring · date-timeRequired

validUntilstring · date-timeRequired

moduleAddressstringRequired

preparedSignaturestringRead-onlyRequired

get

/tx-service/eth/api/v1/safe-operations/{safe_operation_hash}/

HTTPcURLJavaScriptPython

GET /tx-service/eth/api/v1/safe-operations/{safe_operation_hash}/ HTTP/1.1
Accept: */*

200Success

{
  "created": "2026-02-20T19:12:50.554Z",
  "modified": "2026-02-20T19:12:50.554Z",
  "safeOperationHash": "text",
  "validAfter": "2026-02-20T19:12:50.554Z",
  "validUntil": "2026-02-20T19:12:50.554Z",
  "moduleAddress": "text",
  "confirmations": {
    "ANY_ADDITIONAL_PROPERTY": "anything"
  },
  "preparedSignature": "text",
  "userOperation": {
    "ethereumTxHash": "text",
    "sender": "text",
    "userOperationHash": "text",
    "nonce": "text",
    "initCode": null,
    "callData": null,
    "callGasLimit": "text",
    "verificationGasLimit": "text",
    "preVerificationGas": "text",
    "maxFeePerGas": "text",
    "maxPriorityFeePerGas": "text",
    "paymaster": null,
    "paymasterData": null,
    "signature": "text",
    "entryPoint": "text"
  }
}

get

Get the list of confirmations for a multisig transaction

Authorizations

cookieAuthtokenAuth

sessionidstringOptional

Path parameters

safe_operation_hashstringRequired

Query parameters

limitintegerOptional

Number of results to return per page.

offsetintegerOptional

The initial index from which to return the results.

Responses

200Success

application/json

countintegerRequiredExample: 123

nextstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=400&limit=100

previousstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=200&limit=100

400

Invalid data

get

/tx-service/eth/api/v1/safe-operations/{safe_operation_hash}/confirmations/

HTTPcURLJavaScriptPython

GET /tx-service/eth/api/v1/safe-operations/{safe_operation_hash}/confirmations/ HTTP/1.1
Accept: */*

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "created": "2026-02-20T19:12:50.554Z",
      "modified": "2026-02-20T19:12:50.554Z",
      "owner": "text",
      "signature": "text",
      "signatureType": "text"
    }
  ]
}

post

Add a confirmation for a transaction. More than one signature can be used. This endpoint does not support the use of delegates to make a transaction trusted.

Authorizations

cookieAuthtokenAuth

sessionidstringOptional

Path parameters

safe_operation_hashstringRequired

Body

application/json

Validate new confirmations for an existing SafeOperation

signaturestringRequired

Responses

201

Created

400

Malformed data

422

Error processing data

post

/tx-service/eth/api/v1/safe-operations/{safe_operation_hash}/confirmations/

HTTPcURLJavaScriptPython

POST /tx-service/eth/api/v1/safe-operations/{safe_operation_hash}/confirmations/ HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 20

{
  "signature": "text"
}

No content

get

Returns the list of SafeOperations for a given Safe account

Authorizations

cookieAuthtokenAuth

sessionidstringOptional

Path parameters

addressstringRequired

Query parameters

modified__ltstring · date-timeOptional

modified__gtstring · date-timeOptional

modified__ltestring · date-timeOptional

modified__gtestring · date-timeOptional

valid_after__ltstring · date-timeOptional

valid_after__gtstring · date-timeOptional

valid_after__ltestring · date-timeOptional

valid_after__gtestring · date-timeOptional

valid_until__ltstring · date-timeOptional

valid_until__gtstring · date-timeOptional

valid_until__ltestring · date-timeOptional

valid_until__gtestring · date-timeOptional

module_addressstringOptional

executedbooleanOptional

has_confirmationsbooleanOptional

execution_date__gtestring · date-timeOptional

execution_date__ltestring · date-timeOptional

submission_date__gtestring · date-timeOptional

submission_date__ltestring · date-timeOptional

transaction_hashstring · nullableOptional

orderingstringOptional

Which field to use when ordering the results.

limitintegerOptional

Number of results to return per page.

offsetintegerOptional

The initial index from which to return the results.

Responses

200Success

application/json

countintegerRequiredExample: 123

nextstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=400&limit=100

previousstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=200&limit=100

get

/tx-service/eth/api/v1/safes/{address}/safe-operations/

HTTPcURLJavaScriptPython

GET /tx-service/eth/api/v1/safes/{address}/safe-operations/ HTTP/1.1
Accept: */*

200Success

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "created": "2026-02-20T19:12:50.554Z",
      "modified": "2026-02-20T19:12:50.554Z",
      "safeOperationHash": "text",
      "validAfter": "2026-02-20T19:12:50.554Z",
      "validUntil": "2026-02-20T19:12:50.554Z",
      "moduleAddress": "text",
      "confirmations": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "preparedSignature": "text",
      "userOperation": {
        "ethereumTxHash": "text",
        "sender": "text",
        "userOperationHash": "text",
        "nonce": "text",
        "initCode": null,
        "callData": null,
        "callGasLimit": "text",
        "verificationGasLimit": "text",
        "preVerificationGas": "text",
        "maxFeePerGas": "text",
        "maxPriorityFeePerGas": "text",
        "paymaster": null,
        "paymasterData": null,
        "signature": "text",
        "entryPoint": "text"
      }
    }
  ]
}

post

Adds a new SafeOperation for a given Safe account

Authorizations

cookieAuthtokenAuth

sessionidstringOptional

Path parameters

addressstringRequired

Body

application/json

Mixin class to validate SafeOperation signatures. _get_owners can be overridden to define the valid owners to sign

nonceintegerRequired

initCodestring · nullableRequired

callDatastring · nullableRequired

callGasLimitintegerRequired

verificationGasLimitintegerRequired

preVerificationGasintegerRequired

maxFeePerGasintegerRequired

maxPriorityFeePerGasintegerRequired

paymasterAndDatastring · nullableRequired

signaturestringRequired

entryPointstringRequired

validAfterstring · nullableRequired

validUntilstring · nullableRequired

moduleAddressstringRequired

Responses

201Success

application/json

post

/tx-service/eth/api/v1/safes/{address}/safe-operations/

HTTPcURLJavaScriptPython

POST /tx-service/eth/api/v1/safes/{address}/safe-operations/ HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 272

{
  "nonce": 1,
  "initCode": null,
  "callData": null,
  "callGasLimit": 1,
  "verificationGasLimit": 1,
  "preVerificationGas": 1,
  "maxFeePerGas": 1,
  "maxPriorityFeePerGas": 1,
  "paymasterAndData": null,
  "signature": "text",
  "entryPoint": "text",
  "validAfter": null,
  "validUntil": null,
  "moduleAddress": "text"
}

201Success

{
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

get

Returns the list of UserOperations for a given Safe account

Authorizations

cookieAuthtokenAuth

sessionidstringOptional

Path parameters

addressstringRequired

Query parameters

orderingstringOptional

Which field to use when ordering the results.

limitintegerOptional

Number of results to return per page.

offsetintegerOptional

The initial index from which to return the results.

Responses

200Success

application/json

countintegerRequiredExample: 123

nextstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=400&limit=100

previousstring · uri · nullableOptionalExample: http://api.example.org/accounts/?offset=200&limit=100

get

/tx-service/eth/api/v1/safes/{address}/user-operations/

HTTPcURLJavaScriptPython

GET /tx-service/eth/api/v1/safes/{address}/user-operations/ HTTP/1.1
Accept: */*

200Success

{
  "count": 123,
  "next": "http://api.example.org/accounts/?offset=400&limit=100",
  "previous": "http://api.example.org/accounts/?offset=200&limit=100",
  "results": [
    {
      "ethereumTxHash": "text",
      "sender": "text",
      "userOperationHash": "text",
      "nonce": "text",
      "initCode": null,
      "callData": null,
      "callGasLimit": "text",
      "verificationGasLimit": "text",
      "preVerificationGas": "text",
      "maxFeePerGas": "text",
      "maxPriorityFeePerGas": "text",
      "paymaster": null,
      "paymasterData": null,
      "signature": "text",
      "entryPoint": "text",
      "safeOperation": {
        "created": "2026-02-20T19:12:50.554Z",
        "modified": "2026-02-20T19:12:50.554Z",
        "safeOperationHash": "text",
        "validAfter": "2026-02-20T19:12:50.554Z",
        "validUntil": "2026-02-20T19:12:50.554Z",
        "moduleAddress": "text",
        "confirmations": {
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "preparedSignature": "text"
      }
    }
  ]
}

get

Returns a UserOperation given its user operation hash

Authorizations

cookieAuthtokenAuth

sessionidstringOptional

Path parameters

user_operation_hashstringRequired

Responses

200Success

application/json

ethereumTxHashstringRequired

senderstringRequired

userOperationHashstringRequired

noncestringRequired

initCodestring · nullableRequired

callDatastring · nullableRequired

callGasLimitstringRequired

verificationGasLimitstringRequired

preVerificationGasstringRequired

maxFeePerGasstringRequired

maxPriorityFeePerGasstringRequired

paymasterstring · nullableRequired

paymasterDatastring · nullableRequired

signaturestringRequired

entryPointstringRequired

safeOperationone ofRead-onlyRequired

or

nullOptional

get

/tx-service/eth/api/v1/user-operations/{user_operation_hash}/

HTTPcURLJavaScriptPython

GET /tx-service/eth/api/v1/user-operations/{user_operation_hash}/ HTTP/1.1
Accept: */*

200Success

{
  "ethereumTxHash": "text",
  "sender": "text",
  "userOperationHash": "text",
  "nonce": "text",
  "initCode": null,
  "callData": null,
  "callGasLimit": "text",
  "verificationGasLimit": "text",
  "preVerificationGas": "text",
  "maxFeePerGas": "text",
  "maxPriorityFeePerGas": "text",
  "paymaster": null,
  "paymasterData": null,
  "signature": "text",
  "entryPoint": "text",
  "safeOperation": {
    "created": "2026-02-20T19:12:50.554Z",
    "modified": "2026-02-20T19:12:50.554Z",
    "safeOperationHash": "text",
    "validAfter": "2026-02-20T19:12:50.554Z",
    "validUntil": "2026-02-20T19:12:50.554Z",
    "moduleAddress": "text",
    "confirmations": {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "preparedSignature": "text"
  }
}