Skip to main content
GET
/
transaction
Get relayer transaction
curl --request GET \
  --url https://relayer.forka.st/transaction
[
  {
    "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"
  }
]
Fetch a single relayer transaction by transactionID. This endpoint is handy when polling for status updates without downloading the whole history feed.
Send the request to https://relayer.forka.st/transaction and include the same L2 headers required by the other relayer endpoints. Only transactions owned by the authenticated address are returned.

​
Query parameters

NameTypeRequiredDescription
idstringYesULID returned by /submit or /transactions.

​
Notes

  • When no transaction matches the supplied id, you receive an empty array and HTTP 200.
  • state progresses through STATE_ACCEPTED, STATE_BROADCAST, and STATE_MINED; failed submissions reply with STATE_REJECTED alongside an error property.
  • The relayer enforces ownership; querying someone else’s transaction returns an empty list.

Query Parameters

​
id
string
required

Transaction ULID assigned by the relayer.

Response

Transaction fetched (0 or 1 results).

​
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