Skip to main content
Every supertransaction executed by your project is queryable through the dashboard API. Use it to build reporting, reconcile gas spend, or export your full history.

​
Endpoint

GET https://dashboard.biconomy.io/api/public/projects/me/supertransactions
Authenticate with your project API key from dashboard.biconomy.io. Each item in the response includes the supertransaction hash, execution status, chain ids, and payment details (fee token, gas fee, amounts), which is everything needed for cost accounting.

​
Query parameters

ParameterExamplePurpose
lowerBound2026-06-01T00:00:00Zstart of the time window (ISO 8601)
upperBound2026-06-30T23:59:59Zend of the time window
executedOnlytrueonly transactions that actually executed. Recommended for cost accounting
limit100page size
cursortrueenables cursor pagination (recommended, fastest for any history size)
before2026-06-23T18:53:47.554612Zcursor value from the previous page

​
Fetching a time range

First request: provide the window and cursor=true. 
https://dashboard.biconomy.io/api/public/projects/me/supertransactions?lowerBound=2026-06-01T00:00:00Z&upperBound=2026-06-30T23:59:59Z&executedOnly=true&limit=100&cursor=true
Each response carries a pagination object: 
"pagination": {
  "limit": 100,
  "hasNextPage": true,
  "nextCursor": "2026-06-23T18:53:47.554612Z"
}
While hasNextPage is true, repeat the request with &before=<nextCursor> appended: 
...&cursor=true&before=2026-06-23T18:53:47.554612Z
When hasNextPage is false you have covered the whole requested window.

​
Complete example

const BASE = "https://dashboard.biconomy.io/api/public/projects/me/supertransactions";

async function fetchHistory(apiKey: string, lowerBound: string, upperBound: string) {
  const items = [];
  let before: string | undefined;

  while (true) {
    const params = new URLSearchParams({
      lowerBound,
      upperBound,
      executedOnly: "true",
      limit: "100",
      cursor: "true",
      ...(before ? { before } : {})
    });

    const res = await fetch(`${BASE}?${params}`, {
      headers: { "x-api-key": apiKey }
    }).then(r => r.json());

    items.push(...res.data);

    if (!res.pagination?.hasNextPage) break;
    before = res.pagination.nextCursor;
  }

  return items;
}

const history = await fetchHistory(
  API_KEY,
  "2026-06-01T00:00:00Z",
  "2026-06-30T23:59:59Z"
);
console.log(`fetched ${history.length} supertransactions`);

​
Tips

  • For long backfills, iterate month by month, then run a small incremental job for new data.
  • Individual supertransactions can be inspected in detail on MEE Explorer (https://meescan.biconomy.io/details/{stx_hash}) or via the explorer API described in the tracking section.