> ## Documentation Index
> Fetch the complete documentation index at: https://docs.biconomy.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Supertransaction History and Cost Analysis

> Fetch your project's supertransaction history with cursor pagination and analyze execution costs

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](https://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

| Parameter      | Example                       | Purpose                                                                   |
| -------------- | ----------------------------- | ------------------------------------------------------------------------- |
| `lowerBound`   | `2026-06-01T00:00:00Z`        | start of the time window (ISO 8601)                                       |
| `upperBound`   | `2026-06-30T23:59:59Z`        | end of the time window                                                    |
| `executedOnly` | `true`                        | only transactions that actually executed. Recommended for cost accounting |
| `limit`        | `100`                         | page size                                                                 |
| `cursor`       | `true`                        | enables cursor pagination (recommended, fastest for any history size)     |
| `before`       | `2026-06-23T18:53:47.554612Z` | cursor 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:

```json theme={null}
"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

```typescript theme={null}
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) (`https://meescan.biconomy.io/details/{stx_hash}`) or via the explorer API described in the tracking section.