📑 List of transaction checks

GET /api/v1/tx-checks

A paginated list of your checks, most recently updated first. The method is free and convenient for batch polling: instead of requesting every check individually you can fetch a whole page every few seconds.

🛠️ Parameters

Name	In	Type	Required	Description
network	query	string	false	Filter by network: `trx`, `btc`, `eth`, …
query	query	string	false	Search by hash, partial match
limit	query	integer	false	Page size, `15` by default. Values outside the 1–100 range are clamped
page	query	integer	false	Page number, `1` by default

Sorting is by updated_at descending: checks that have just finished appear at the top of the first page.

Example request

curl 'https://amlkyc.tech/api/v1/tx-checks?network=trx&limit=50' \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Accept: application/json'

Example responses

200 Response

{
  "success": true,
  "data": {
    "items": [
      {
        "id": 128,
        "uuid": "0f2d3a51-6f1a-4a2f-9f2f-2a5a0c9d7b41",
        "hash": "e54ca4ba8ff7034b1e11e764c50f65fdfc5fb0394fe986ec4d96aff2b4230598",
        "network": "trx",
        "status": 2,
        "status_label": "done",
        "score": 77,
        "summary": {
          "network": "trx",
          "hash": "e54ca4ba8ff7034b1e11e764c50f65fdfc5fb0394fe986ec4d96aff2b4230598",
          "block": 68123456,
          "contractRet": "SUCCESS",
          "timestamp": 1759132364000,
          "amount": "1500.000000",
          "asset": "USDT",
          "from": [
            "TLXvVN23UkxS4SW4JuQMhAYw9NNP8zwGyA"
          ],
          "to": [
            "TFq8GqCTiJA1PAnCJjtqDMHTRAsZgKNaYk"
          ]
        },
        "results": [
          {
            "address": "TLXvVN23UkxS4SW4JuQMhAYw9NNP8zwGyA",
            "direction": "in",
            "score": 77,
            "labels": [
              "Mixer"
            ]
          }
        ],
        "error": null,
        "created_at": "2026-09-29T09:12:44.000000Z",
        "updated_at": "2026-09-29T09:13:58.000000Z"
      }
    ],
    "meta": {
      "total": 42,
      "per_page": 50,
      "current_page": 1,
      "last_page": 1
    }
  }
}

📦 Response envelope

Field	Type	Description
data.items	array	Check records with the same set of fields as the check record
data.meta.total	integer	Total number of checks matching the filters
data.meta.per_page	integer	Page size
data.meta.current_page	integer	Current page
data.meta.last_page	integer	Last page

Pagination here differs from quick checks on the legacy /api surface: there the fields sit at the root of the response (total, perPage, page, lastPage), here they live inside data.meta in snake_case.

🔁 Responses

Status	Meaning	Description
200	OK	List of checks
401	Unauthorized	The token is missing or invalid
403	Forbidden	Transaction checks are not enabled for the account