Skip to main content
GET
/
transactions
List relayer transactions
curl --request GET \
  --url https://relayer.forka.st/transactions
[
  {
    "transactionID": "01JAA0Y2Q9M5T8M6P5HAX7F1RM",
    "transactionHash": "0xaabc8230e2bf9c5f5d514b8a9be4739fce8c17b1d0a4b8d9ae8ea7e7da65e021",
    "from": "0x0B2B3E6B323C0Cd7bEaf4B7cC73b983D4E9B12c7",
    "to": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
    "proxyAddress": "0x3f8Be6FC21f4a5127A42CE1aF58d8bCb8A94F3c1",
    "data": "0x095ea7b30000000000000000000000004d97dcd97ec945f40cf65f87097ace5ea0476045ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
    "nonce": "7",
    "value": "0",
    "state": "STATE_MINED",
    "type": "SAFE",
    "metadata": "first USDC approve",
    "createdAt": "2025-02-15T18:29:12.417Z",
    "updatedAt": "2025-02-15T18:30:05.019Z"
  }
]
Inspect every transaction the authenticated account has submitted to the relayer. The feed covers Safe deployments, Safe executions, and ProxyWallet relays along with their current state and hashes.
Call https://relayer.forka.st/transactions with the standard L2 headers. The relayer derives the account from your credentials and automatically scopes the response.

​
Response payload

Each element in the returned array exposes the metadata Forkast stores for the transaction.
FieldTypeDescription
transactionIDstringULID assigned when the relayer accepts the request.
transactionHashstringOn-chain transaction hash when broadcast.
fromstringSource address (Safe owner or Proxy wallet).
tostringDestination contract.
proxyAddressstringProxy wallet executing the call, when applicable.
datastring0x-encoded calldata sent on-chain.
noncestringDecimal nonce used by the relayer.
valuestringAmount of wei forwarded with the call.
statestringCurrent lifecycle state such as STATE_ACCEPTED, STATE_MINED, or STATE_FAILED.
typestringOperation type (SAFE, SAFE-CREATE, or PROXY).
metadatastring|nullFree-form string stored alongside the submission.
createdAtstringISO 8601 timestamp for initial persistence.
updatedAtstringISO 8601 timestamp for the latest state transition.

​
Notes

  • Results are returned in descending createdAt order; use client-side filtering for pagination.
  • Only the authenticated account may access its history. Requests with mismatched headers respond with 403.
  • When a transaction is still pending, transactionHash may be null until the relayer broadcasts it.

Response

Transactions fetched successfully.

​
transactionID
string
required
​
from
string
required
​
to
string
required
​
nonce
string
required
​
state
string
required

Current lifecycle state tracked by the relayer.

​
type
string
required

Operation type such as SAFE, SAFE-CREATE, or PROXY.

​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
transactionHash
string | null
​
proxyAddress
string | null
​
data
string
​
value
string
​
metadata
string | null