> For the complete documentation index, see [llms.txt](https://docs.misttrack.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.misttrack.io/api-endpoints/get-str-snapshot-records.md).

# Get STR Snapshot Records

Return stored risk-report snapshots. Filters and pagination are optional.

```shell
GET https://openapi.misttrack.io/v1/str_snapshot_records
    ?api_key=YourApiKey
    &page=1
```

> Try this endpoint in your [browser](https://openapi.misttrack.io/v1/str_snapshot_records?api_key=YourApiKey\&page=1) 🔗

## Request

Query Parameters

<table><thead><tr><th width="101.2578125">Parameter</th><th width="89.859375">Type</th><th width="91.89453125">Required</th><th>Description</th></tr></thead><tbody><tr><td>api_key</td><td>string</td><td>yes</td><td>Your API key.</td></tr><tr><td>address</td><td>string</td><td>no</td><td>Return reports matching this requested address.</td></tr><tr><td>txid</td><td>string</td><td>no</td><td>Return reports matching this transaction hash. If provided, it must have a valid transaction-hash format.</td></tr><tr><td>risk_level</td><td>string</td><td>no</td><td>Filter by <code>low</code>, <code>moderate</code>, <code>high</code>, or <code>severe</code> (lowercase).</td></tr><tr><td>page</td><td>int</td><td>no</td><td>Page number, from <code>1</code> through <code>10</code>. Default: <code>1</code>.</td></tr></tbody></table>

## Response

Snapshots are returned in the top-level `risk_reports` array, not under `data`. An empty result is `"risk_reports": []`.

<table><thead><tr><th width="159.0625">Parameter</th><th width="83.046875">Type</th><th>Description</th></tr></thead><tbody><tr><td>req_timestamp</td><td>string</td><td>Time recorded for the original risk-score request.</td></tr><tr><td>req_coin</td><td>string</td><td>Coin used in the original request.</td></tr><tr><td>req_address</td><td>string</td><td>Address in the original request; may be empty for a transaction query.</td></tr><tr><td>req_txid</td><td>string</td><td>Transaction hash in the original request; may be empty for an address query.</td></tr><tr><td>resp_risk_score</td><td>int</td><td>Risk score returned for the original request.</td></tr><tr><td>resp_risk_level</td><td>string</td><td>Risk level, converted to lowercase.</td></tr><tr><td>report_url</td><td>string</td><td>URL of the associated risk report.</td></tr><tr><td>trigger_src</td><td>string</td><td>Source of the report. Defaults to <code>OpenAPI</code> when no source is recorded.</td></tr></tbody></table>

Sample Response

```json
{
  "success": true,
  "msg": "",
  "risk_reports": [
    {
      "req_timestamp": "2026-09-28 10:00:00",
      "req_coin": "ETH",
      "req_address": "0xb3065fe2125c413e973829108f23e872e1db9a6b",
      "req_txid": "",
      "resp_risk_score": 75,
      "resp_risk_level": "high",
      "report_url": "https://files.misttrack.io/riskReport/0xb3065fe2125c413e973829108f23e872e1db9a6b?token=example-report-id",
      "trigger_src": "OpenAPI"
    }
  ]
}
```

## Error Responses

<table><thead><tr><th width="110.28125">HTTP Status</th><th>Response</th><th>Meaning</th></tr></thead><tbody><tr><td>200</td><td><code>{"success": false, "msg": "InvalidParameter"}</code></td><td>Page is outside <code>1</code>–<code>10</code>, or <code>txid</code> or <code>risk_level</code> is invalid.</td></tr><tr><td>200</td><td><code>{"success": false, "msg": "InvalidApiKey"}</code></td><td>API key is missing, invalid, or deleted.</td></tr><tr><td>200</td><td><code>{"success": false, "msg": "PermissionDenied"}</code></td><td>The user does not have permission for this module.</td></tr><tr><td>402</td><td><code>{"success": false, "msg": "ExpiredPlan"}</code></td><td>The API plan has expired.</td></tr></tbody></table>
