GET/api/v1/contract-calls

List token actions

Lists the history of actions performed on one token, each with the action name, the arguments it was called with, its payload hash, the proposal carrying it, and its current status.

AccessRequires a permission in the workspacePAYMENT_APPROVEPAYMENT_INITVIEW_BALANCES

Every action submitted through POST /api/v1/call-contract is recorded here: what was called, with which arguments, and how far it got. Read a call's Status for its progress, and pass its UID to POST /api/v1/contract-calls/resubmit when a call stalled before reaching the network.

This response uses capitalised field names. PsbtID, ArgsJSON, and PayloadHex are null until they are set, so a call that has not yet been built into a proposal carries no PsbtID. ArgsJSON is the args array as it was sent, encoded as a JSON string.

Query parameters

contract_uidnumberrequired

The token whose action history to list.

workspace_idnumberrequired

The workspace the token belongs to. You must hold PAYMENT_APPROVE, PAYMENT_INIT, or VIEW_BALANCES in it.

bash

curl "$SQRL_API/api/v1/contract-calls?contract_uid=512&workspace_id=342" \
  -H "authorization: Bearer $SQRL_TOKEN"

const params = new URLSearchParams({
  contract_uid: "512",
  workspace_id: "342",
});
const res = await fetch(
  `${process.env.SQRL_API}/api/v1/contract-calls?${params}`,
  { headers: { authorization: `Bearer ${process.env.SQRL_TOKEN}` } },
);
const { calls } = await res.json();

rust

let res = client
    .get(format!("{}/api/v1/contract-calls", api_base))
    .query(&[("contract_uid", "512"), ("workspace_id", "342")])
    .bearer_auth(&token)
    .send()
    .await?;

Response200 OK

{
"calls": [
  {
    "UID": 8842,
    "ContractUID": 512,
    "PsbtID": "psbt_01HZXC9F4R",
    "FunctionName": "transfer",
    "ArgsJSON": "[{\"type\":\"str\",\"value\":\"bc1qm34lsc65zpw79lxes69zkqmk6ee3ewf0j77s3h\"},{\"type\":\"int\",\"value\":150000}]",
    "CallID": "call_01HZXE6P2N",
    "PayloadHash": "c4e8a1f7…2db",
    "PayloadHex": "0a2f74726…1f",
    "Status": "CONFIRMED",
    "CreatedAt": "2026-08-03T11:41:52Z"
  },
  {
    "UID": 8846,
    "ContractUID": 512,
    "PsbtID": null,
    "FunctionName": "pause",
    "ArgsJSON": null,
    "CallID": "call_01HZXFB2QD",
    "PayloadHash": "7d90b3ce…14a",
    "PayloadHex": null,
    "Status": "PENDING",
    "CreatedAt": "2026-08-04T08:07:19Z"
  }
]
}

Was this page helpful?