---
title: "Retrieve list of customer transactions"
method: GET
path: "/transactions/customers/{id}/history-aggregate"
tags: ["transactions-transactions"]
---

# Retrieve list of customer transactions

`GET /transactions/customers/{id}/history-aggregate`

## Request

- Base URL: `https://external.dev.onboardpay.co`
- URL: `https://external.dev.onboardpay.co/transactions/customers/{id}/history-aggregate`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/docs/transactions/customers/:id/history-aggregate/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` string, uuid, required

## Query parameters

- `transactionType` 'ONRAMP' | 'OFFRAMP': Transaction order type, can be ONRAMP or OFFRAMP
- `from` string
- `to` string
- `statuses` TransactionOrderStatus[]
- `token` string
- `fiat` string
- `network` string
- `paymentChannel` string
- `reference` string
- `otherPartyId` string, uuid
- `isTradeRequestBroadcast` boolean

## Response `200`

Success

- TransactionHistoryAggregate
  - `userId` string, uuid
  - `tradeCount` integer, required
  - `tradeUsdTotal` number, required
  - `fiatTotal` number
  - `tokenTotal` number

## Other responses

- `400`: Bad request
- `401`: Unauthorized request
- `500`: Server error

## Changes

- **2026-07-26** `a3c4e2742615`: 2 info
  - the endpoint scheme security `HMACAuth` was added to the API
  - the endpoint scheme security `authToken` was removed from the API

[Operation history](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/changes/transactions/customers/:id/history-aggregate/get.md)

---

[API](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway.md) - [All operations](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/nestechops/apis/onboard-external-api-gateway/revisions/5da9ec1b2573?raw)