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

# Get Transactions

> Retrieve your paginated transaction history

Returns all transactions on your business account (deposits, withdrawals, redemptions, and bridges), newest first.

### Query parameters

<ParamField query="page" type="number" default="1">
  Page number to fetch.
</ParamField>

<ParamField query="limit" type="number" default="10">
  Number of records per page.
</ParamField>

### Response (decrypted `data`)

<ResponseField name="data" type="object[]">
  Array of transaction records.

  <Expandable title="Transaction object">
    <ResponseField name="id" type="string">Unique transaction ID.</ResponseField>
    <ResponseField name="from" type="string">Sender identifier or address.</ResponseField>

    <ResponseField name="receiver" type="object">
      Either `{ "address": "0x..." }` for on-chain transfers or `{ "bank": "...", "accountNumber": "..." }` for fiat settlement.
    </ResponseField>

    <ResponseField name="amount" type="string">Transaction amount.</ResponseField>
    <ResponseField name="description" type="string">Human-readable description.</ResponseField>
    <ResponseField name="createdAt" type="string">ISO 8601 creation timestamp.</ResponseField>
    <ResponseField name="trx_ref" type="string">Transaction reference. Use it with [Verify Withdrawal](/api-reference/verify-withdrawal).</ResponseField>
    <ResponseField name="trx_type" type="string">Transaction type (e.g. `deposit`, `withdrawal`, `redeem`, `swap`).</ResponseField>
    <ResponseField name="network" type="string">Network the transaction executed on.</ResponseField>
    <ResponseField name="asset_type" type="string">Asset classification.</ResponseField>
    <ResponseField name="asset_symbol" type="string">Asset ticker (`CNGN`).</ResponseField>
    <ResponseField name="base_trx_hash" type="string | null">On-chain hash on the origin network, if applicable.</ResponseField>
    <ResponseField name="extl_trx_hash" type="string | null">On-chain hash on the external/destination network, if applicable.</ResponseField>
    <ResponseField name="explorer_link" type="string | null">Block explorer URL for the transaction.</ResponseField>
    <ResponseField name="status" type="string">Transaction status (e.g. `pending`, `success`, `failed`).</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Standard pagination metadata. See [Response Format](/guides/response-format#pagination).
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.cngn.co/v1/api/transactions?page=1&limit=10" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    "https://api.cngn.co/v1/api/transactions?page=1&limit=10",
    { headers: { Authorization: `Bearer ${API_KEY}` } }
  );
  ```

  ```python Python theme={null}
  res = requests.get(
      "https://api.cngn.co/v1/api/transactions",
      params={"page": 1, "limit": 10},
      headers={"Authorization": f"Bearer {API_KEY}"},
  )
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success (data shown decrypted) theme={null}
  {
    "status": 200,
    "message": "Transactions fetched successfully",
    "data": {
      "data": [
        {
          "id": "9f8b7c6d-5e4f-4a3b-9c2d-1e0f9a8b7c6d",
          "from": "Acme Ltd",
          "receiver": { "address": "0x8Ba1f109551bD432803012645Ac136ddd64DBA72" },
          "amount": "25000.00",
          "description": "Withdrawal to external wallet",
          "createdAt": "2026-07-20T14:32:11.000Z",
          "trx_ref": "WD-7f3a2b1c",
          "trx_type": "withdrawal",
          "network": "Base",
          "asset_type": "credit_alphanum4",
          "asset_symbol": "CNGN",
          "base_trx_hash": "0x4a5b...e9f0",
          "extl_trx_hash": null,
          "explorer_link": "https://basescan.org/tx/0x4a5b...e9f0",
          "status": "success"
        }
      ],
      "pagination": {
        "count": 42,
        "pages": 5,
        "isLastPage": false,
        "nextPage": 2,
        "previousPage": null
      }
    }
  }
  ```
</ResponseExample>
