POST/users/{userId}/accounts/{accountType}/history

User Account History

Returns the transaction history for a specific user account. Supports filtering by date range, direction, transaction type, and description.

Path variables

FieldTypeRequiredPossible valuesDescription
userIdstringRequired

Unique user ID.

accountTypestringRequiredUSD

Account type identifier.

Query parameters

FieldTypeRequiredPossible valuesDescription
pageNumberintegerOptional

Page number (enter 1 for the first page, 2 for the second, etc.).

pageSizeintegerOptional10 | 20 | 40 | 100

Number of records per page.

Headers

FieldTypeRequiredPossible valuesDescription
session-tokenstringRequired

SessionToken obtained from the Create GMA Session endpoint. All secured endpoints require this header.

Request body

FieldTypeRequiredPossible valuesDescription
DescriptionstringOptional

Filter transactions by description.

TransferTypestringOptionalFVNet | 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.

OrderBystringOptionalamountAsc | amountDesc | dateAsc | dateDesc

Sort order for results.

FromDatestringOptionalYYYY-MM-DD

Start date filter (ISO 8601).

ToDatestringOptionalYYYY-MM-DD

End date filter (ISO 8601).

Example request

{}

Response

FieldTypePossible valuesDescription
ResponseCodeinteger200 | 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).

ResponseMessagestringSuccess | 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.

ResponseDataobjectPlease 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.

Search guide books, endpoints, paths, or parameters

↑↓navigateopenEscclose