> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hel.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Deposit Transactions by Customer Token
> Get all transactions for a deposit by customer token
**Note:** When using the production environment at [moonpay.hel.io](http://app.hel.io), set your API endpoint to `api.hel.io/v1` and generate API keys there. For the development environment, use `api.dev.hel.io/v1` and generate API keys from [moonpay.dev.hel.io](http://app.dev.hel.io).
## OpenAPI
````yaml GET /v1/transactions/deposit/customer/{depositCustomerToken}/transactions
openapi: 3.0.0
info:
title: Helio Open API
description: |-
API schema and definitions for Helio API.
The API is using two types of Authentication, for dashboard endpoints we use JSON Web Token (JWT) that is generated by self custodial wallet signing a message from API.
We also support authentication with API Key and Secret which can be generated on Helio dashboard.
version: 1.0.0
contact: {}
servers:
- description: Helio API (Mainnet)
url: https://api.hel.io
- description: Helio API (Devnet)
url: https://api.dev.hel.io
security: []
tags:
- name: Webhooks
- name: Exports
- name: Currencies
description: >-
Supported currencies endpoint, includes fiat and digital assets
Authentication: None
externalDocs:
description: Helio product documentation
url: https://docs.hel.io/
paths:
/v1/transactions/deposit/customer/{depositCustomerToken}/transactions:
get:
tags:
- Deposits
summary: Get Deposit Transactions by Customer Token
description: Get all transactions for a deposit by customer token
operationId: DepositController_getCustomerTransactions
parameters:
- name: depositCustomerToken
in: path
required: true
description: >-
The unique token associated with the deposit customer used to
retrieve all related transactions.
schema:
type: string
- name: apiKey
in: query
required: true
description: >-
Your API key, which can be generated from the Helio Dashboard
settings page.
schema:
type: string
- name: senderPK
in: query
required: false
description: Filter results by sender public key.
schema:
type: string
- name: to
required: false
in: query
description: >-
The end of the time range for filtering transactions, in ISO 8601
format (YYYY-MM-DDTHH:MM:SS.sssZ).
schema:
type: string
- name: from
required: false
in: query
description: >-
The start of the time range for filtering transactions, in ISO 8601
format (YYYY-MM-DDTHH:MM:SS.sssZ).
schema:
type: string
responses:
'200':
description: >-
The deposit transactions for a specific customer were successfully
retrieved
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/CreateDepositCustomer'
examples:
exportedPaymentsList:
summary: >-
Example of a successful “Get Deposit Transaction” response
for a particular customer
value:
- id: 6900a6c3165d5f39c92828d1
fee: '120000'
createdAt: '2025-10-28T11:19:31.812Z'
paymentType: DEPOSIT
deposit:
id: 6900a5e3eaacfdbd980fd9fe
description: ''
name: deposittest
platform: HELIO
createdAt: '2025-10-28T11:15:47.789Z'
updatedAt: '2025-10-28T11:15:47.789Z'
currencies:
- id: 63430c8348c610068bcdc482
name: USD Coin
decimals: 6
order: 100
mintAddress: 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU
coinMarketCapId: 3408
symbol: USDC
symbolPrefix: $
type: DIGITAL
iconUrl: USDC.svg
features:
- PAYMENT_PRICING
- PAYMENT_RECIPIENT
- SWAP
- DEPOSIT_MERCHANT_RECIPIENT
- DEPOSIT_CUSTOMER_CHECKOUT
orderingType: NUMERIC
blockchain:
id: 63430c8348c610068bcdc43c
name: SOL
symbol: SOL
engine:
id: 63b574b9d07b6f6f21c13eb2
type: SOL
company:
id: 667c3e5bc3d87bccd2035dbe
name: ''
email: ''
websiteUrl: ''
address: ''
phoneNumber: ''
escrowFunds: false
twitterConfirmed: false
kycVerified: false
kybVerified: true
customTheme:
primaryColor: '#6400CC'
neutralColor: '#5A6578'
themeMode: LIGHT
textColorOnButton: BLACK
backgroundColor: '#f9f9f9'
creator:
id: 667c3e5bc3d87bccd2035dbc
userType: MERCHANT
email: jesse@hel.io
isDisabled: false
kycVerified: false
platformDetails:
platform: HELIO
depositCustomer:
id: 6900a5ea1a21b23ddb1b1e65
deposit: 6900a5e3eaacfdbd980fd9fe
token: 22c3ff68-5f1b-48c7-b5c6-e0e7b0b91ab4
customerId: test342
recipientPublicKeys:
- 7YancRyNQyp9s6G7YNwx9H93UqswoKWqF9GuNJPufyvW
meta:
id: 6900a6c3165d5f39c92828cf
amount: '5880000'
senderPK: 44NrPTjxg5anqkNLnnvKvBhPcrhyTAGecXjyR2LzpEap
recipientPK: 7YancRyNQyp9s6G7YNwx9H93UqswoKWqF9GuNJPufyvW
transactionType: DEPOSIT
customerDetails: {}
productDetails: null
additionalProductDetails: []
transactionSignature: >-
2v4NPfeLFGokWYRBqjwwS7SLHrq1HnuKuriy3p5UDspABYoasJd2SqrZvMipsZP5U8dwEDeaL3NWigdjVrnKj43Y
transactionStatus: SUCCESS
splitRevenue: false
remainingAccounts: []
totalAmount: '5880000'
totalAmountAsUSD: '5880000'
tokenQuote: null
shopifyPaymentDetails: null
currency:
id: 63430c8348c610068bcdc482
name: USD Coin
decimals: 6
order: 100
mintAddress: 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU
coinMarketCapId: 3408
symbol: USDC
symbolPrefix: $
type: DIGITAL
iconUrl: USDC.svg
features:
- PAYMENT_PRICING
- PAYMENT_RECIPIENT
- SWAP
- DEPOSIT_MERCHANT_RECIPIENT
- DEPOSIT_CUSTOMER_CHECKOUT
orderingType: NUMERIC
blockchain:
id: 63430c8348c610068bcdc43c
name: SOL
symbol: SOL
engine:
id: 63b574b9d07b6f6f21c13eb2
type: SOL
paymentRequestCreatorId: 667c3e5bc3d87bccd2035dbc
paymentRequestName: deposittest
paymentRequestCurrencySymbol: USDC
paymentRequestBlockchain: SOL
incomingTransactions:
- hash: >-
2azE2LdA7JATeKEvt1aUiWJmFbKSZ9ZgJntXjdjniBrtDhrECj8ZB5BUai5pdbWR2gioMT5Go1cAQbKiB3gBsgrc
from: 7YancRyNQyp9s6G7YNwx9H93UqswoKWqF9GuNJPufyvW
to: 6C6gzbxQ1rc5vEbnycWGmTNmLcDhavsNi6C5nAMWEfYn
value: '48102183'
blockNumber: 437805392
timestamp: 1769440895
status: success
gasUsed: '5000'
gasPrice: '20000000000'
nonce: 12
'401':
description: Provided API key has no access to the resource.
content:
application/json:
examples:
unauthorized:
summary: Invalid or missing API key
value:
message: Api key or token is invalid
code: 401
security:
- bearer: []
components:
schemas:
CreateDepositCustomer:
type: object
properties:
customerId:
type: string
description: >-
Merchant-defined unique identifier used to reference the customer in
the merchant’s system.
depositId:
type: string
description: Identifier of the deposit.
recipientPublicKeys:
type: array
description: List of recipient public keys.
minItems: 1
maxItems: 1
items:
type: string
defaultOnrampAmount:
type: integer
description: The default on-ramp amount to prefill for the customer.
customerEmail:
type: string
description: >-
Prefills the email field in the MoonPay on-ramp widget for the
customer.
additionalJSON:
type: string
description: Optional JSON string containing metadata.
blockchainEngineTypes:
type: array
description: >-
Optional list of blockchain engines to provision deposit wallets
for. When omitted, wallets are created for all supported engines
(SOL, BTC, EVM, TRON, HYPERCORE, DOGE). Use this to limit which
deposit addresses are generated — for example, pass ["EVM", "BTC"]
to skip SOL if you handle Solana deposits yourself.
uniqueItems: true
items:
type: string
enum:
- SOL
- BTC
- EVM
- TRON
- HYPERCORE
- DOGE
required:
- customerId
- depositId
- recipientPublicKeys
securitySchemes:
bearer:
type: http
scheme: bearer
bearerFormat: JWT
description: Authentication using JWT token
````