/users/{userId}/accounts/{accountType}/historyUser Account History
Returns the transaction history for a specific user account. Supports filtering by date range, direction, transaction type, and description.
Path variables
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
userId | string | Required | — | Unique user ID. |
accountType | string | Required | USD | Account type identifier. |
Query parameters
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
pageNumber | integer | Optional | — | Page number (enter 1 for the first page, 2 for the second, etc.). |
pageSize | integer | Optional | 10 | 20 | 40 | 100 | Number of records per page. |
Headers
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
session-token | string | Required | — | SessionToken obtained from the Create GMA Session endpoint. All secured endpoints require this header. |
Request body
| Field | Type | Required | Possible values | Description |
|---|---|---|---|---|
Description | string | Optional | — | Filter transactions by description. |
TransferType | string | Optional | FVNet | ACH | WIRE | INTERNATIONAL_WIRE | STABLECOIN_WITHDRAW | CROSS_BORDER_AED_DOMESTIC | CROSS_BORDER_AED_WIRE | CROSS_BORDER_ARS_DOMESTIC | CROSS_BORDER_BRL_DOMESTIC | CROSS_BORDER_CAD_DOMESTIC | CROSS_BORDER_CAD_WIRE | CROSS_BORDER_SEPA | CROSS_BORDER_EUR_WIRE | CROSS_BORDER_FASTER_PAYMENTS | CROSS_BORDER_GBP_WIRE | CROSS_BORDER_HKD_DOMESTIC | CROSS_BORDER_HKD_WIRE | CROSS_BORDER_JPY_DOMESTIC | CROSS_BORDER_JPY_WIRE | CROSS_BORDER_CLABE | CROSS_BORDER_MXN_WIRE | CROSS_BORDER_SGD_DOMESTIC | CROSS_BORDER_SGD_WIRE | CROSS_BORDER_ZAR_DOMESTIC | CROSS_BORDER_ZAR_WIRE | Filter by transaction / transfer type. |
OrderBy | string | Optional | amountAsc | amountDesc | dateAsc | dateDesc | Sort order for results. |
FromDate | string | Optional | YYYY-MM-DD | Start date filter (ISO 8601). |
ToDate | string | Optional | YYYY-MM-DD | End date filter (ISO 8601). |
Example request
{}Response
| Field | Type | Possible values | Description |
|---|---|---|---|
ResponseCode | integer | 200 | 201 | 204 | 301 | 400 | 401 | 403 | 404 | 410 | 422 | 500 | 503 | API result code in the response envelope. Indicates success or the error category (e.g. 200 success, 400 bad request, 401 unauthorized). |
ResponseMessage | string | Success | Created | NoContent | BadRequest | Unauthorized | Forbidden | NotFound | Gone | UnprocessableContent | ServerError | ResourceMoved | ServiceUnAvailable | UnProcessableEntity | Human-readable label paired with ResponseCode (e.g. Success, BadRequest, Unauthorized). Use with ResponseCode to interpret the outcome. |
ResponseData | object | Please refer to below example for response body | Paginated transaction history for the user account. |
Example response
{
"ResponseCode": 200,
"ResponseMessage": "Success",
"ResponseData": {
"Data": [
{
"TransactionNumber": "FV000749152",
"Date": "2026-07-17T03:40:40.592-04:00",
"Amount": "-2.90",
"TransferType": "CROSS_BORDER_MXN_WIRE",
"DisplayTransferType": "Payment - Cross Border - MXN Wire Payments",
"Direction": "DEBIT",
"To": "Test test"
},
{
"TransactionNumber": "FV000749148",
"Date": "2026-07-17T03:42:20.319-04:00",
"Amount": "-30.00",
"TransferType": "ACH",
"DisplayTransferType": "Payment - Domestic (ACH)",
"Description": "TEst",
"Direction": "DEBIT",
"To": "Test test"
},
{
"TransactionNumber": "FV000749172",
"Date": "2026-07-21T08:06:59.324-04:00",
"Amount": "30.00",
"TransferType": "FVNet",
"DisplayTransferType": "Payment - FV Net",
"Direction": "CREDIT",
"From": "Account (USD)"
},
{
"TransactionNumber": "FV000749149",
"Date": "2026-07-17T03:42:03.520-04:00",
"Amount": "-35.00",
"TransferType": "WIRE",
"DisplayTransferType": "Payment - Domestic Wire",
"Direction": "DEBIT",
"To": "Test test"
},
{
"TransactionNumber": "FV000749179",
"Date": "2026-07-23T02:17:13.294-04:00",
"Amount": "-60.00",
"TransferType": "INTERNATIONAL_WIRE",
"DisplayTransferType": "Payment - International Wire",
"Direction": "DEBIT",
"To": "Test test"
},
{
"TransactionNumber": "FV000749168",
"Date": "2026-07-22T01:11:10.774-04:00",
"Amount": "-100.00",
"TransferType": "FVNet",
"DisplayTransferType": "Payment - FV Net",
"Description": "Test",
"Direction": "DEBIT",
"To": "Account (USD)"
},
{
"TransactionNumber": "FV000749147",
"Date": "2026-07-17T03:15:29.862-04:00",
"Amount": "50000.00",
"TransferType": "debit.BUS_ACH_Deposit",
"DisplayTransferType": "CREDIT - ACH DOMESTIC TRANSACTION",
"Direction": "CREDIT",
"From": "User"
}
],
"CurrentPage": 1,
"PageSize": 40,
"TotalCount": 517
}
}Requires `session-token: {SessionToken}` from Create GMA Session. Use the same client IP as authentication.