---
title: "Get Deposit Customer Activity"
method: GET
path: "/v1/deposit-customers/{depositCustomerToken}/activity"
tags: ["Deposits"]
---

# Get Deposit Customer Activity

`GET /v1/deposit-customers/{depositCustomerToken}/activity`

## Request

- Base URL: `https://api.hel.io`
- URL: `https://api.hel.io/v1/deposit-customers/{depositCustomerToken}/activity`
- Auth: none declared

Returns a paginated list of deposit transaction activity for a deposit customer, identified by their **deposit customer token**. Each item summarises a single deposit: amounts sent/received (in minimal units, as strings), the source and destination networks, the current status, and the delivery time once settled.

**Authentication:** none (public). The deposit customer token in the path is the credential — keep it secret as you would an API key.

## Path parameters

- `depositCustomerToken` string, required

## Query parameters

- `transactionStatus` 'INITIATED' | 'PENDING' | 'BRIDGING' | 'SUCCESS' | 'FAILED' | 'CANCELED' | 'SETTLED' | 'REFUNDED'
- `page` number
- `limit` number
- `lastItemId` string
- `sort` string
- `order` string
- `search` string
- `startDate` string
- `endDate` string

## Response `200`

Paginated deposit customer activity.

- DepositCustomerActivityResponse
  - `data` DepositCustomerActivityItem[]
    - `id` string: Unique identifier of the deposit transaction.
    - `transactionSignature` string: On-chain transaction signature/hash for the deposit.
    - `amountSent` string: Gross amount sent by the customer, in the currency's minimal units (stringified integer).
    - `amountReceived` string: Net amount received after fees, in the currency's minimal units (stringified integer).
    - `amountReceivedUsd` string: Net amount received expressed in USD minimal units (stringified integer).
    - `currencySymbol` string: Symbol of the received currency (e.g. USDC).
    - `currencyDecimals` number: Number of decimals for the received currency, used to convert the minimal-unit amounts to a human-readable value.
    - `sourceNetwork` string: Blockchain the funds originated from (e.g. SOL, ETH).
    - `destinationNetwork` string: Blockchain the funds were settled to.
    - `status` 'INITIATED' | 'PENDING' | 'BRIDGING' | 'SUCCESS' | 'FAILED' | 'CANCELED' | 'SETTLED' | 'REFUNDED': Current status of the transaction.
    - `deliveryTimeMs` number, nullable: Time in milliseconds between transaction creation and successful settlement. Null when the transaction has not settled successfully.
    - `createdAt` string, date-time: ISO 8601 timestamp of when the transaction was created.
  - `total` number: Total number of activity items matching the query.
  - `page` number: Current page number.
  - `limit` number: Page size used for this response.

## Other responses

- `404`: The deposit customer token is unknown or related data could not be found.

---

[API](https://skmtc.dev/hel/apis/helio-open-api.md) - [All operations](https://skmtc.dev/hel/apis/helio-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hel/apis/helio-open-api/revisions/5988f1c713e0?raw)