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

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 to return per page must be an integer between 1 and 100.

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 \| CROSS_BORDER_CLP_DOMESTIC \| CROSS_BORDER_COP_DOMESTIC \| CROSS_BORDER_DKK_DOMESTIC \| CROSS_BORDER_IDR_DOMESTIC \| CROSS_BORDER_PEN_DOMESTIC \| CROSS_BORDER_AUD_DOMESTIC \| CROSS_BORDER_MYR_DOMESTIC \| CROSS_BORDER_KRW_DOMESTIC \| CROSS_BORDER_THB_DOMESTIC \| CROSS_BORDER_VND_DOMESTIC	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
  }
}

{
  "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.